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INTRODUCTION 


If you use your Apple Il personal computer often enough, long enough, and 
late enough, eventually your Apple may decide to reveal “ІТ” to you. 

ЧТ" is а series of revelations on where we came from, where we are, and 
where we are heading. Most often, your Apple will reveal “ІТ” to you very early 
on some morning in your second or third year of Apple use. 

The "IT" revelation is for real. Just ask anyone who has worked with an Apple 
long enough. The wry smile and knowing nod tells all. 

If my Apple will forgive me, I'd like to reveal some of the present "IT^ 
messages to you, for they say a lot... 





The Apple II is far and away the single most powerful tool ever put in the 
hands of many individuals on an uncontrolled and unregulated basis. The new 
personal freedoms and the potential opportunities that result from this are almost. 
beyond belief. It's now a whole new ball game, a jump into hyperspace from 
where we are. The Apple Il is far more significant and it will have a vastly greater 
impact than such short term frivolities as the automobile and television—and, 
possibly, even more than the printed word itself. Even time may eventually be 
measured as “ВА” and "AA," split at that magic date in the spring of 1977. 


The Apple experience is absolutely and totally unique. There is no other 
product available anywhere, at any price, that adapts itself as easily, as well, and 
as conveniently to whole new worlds of strong user-oriented applications. The 
unbridled potential of Apple’s sixteen 1/О sockets is utterly awesome. 





Future historians will recognize the Apple Il as the DC-3 of the microcomputer 
revolution. 


There are several reasons for Apple's success. The first is simply being in the 
right place at the right time. The second is blind luck. But, the third and most 
important reason is that Apple has lacked ‘‘us-versus-them.”” 
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Apple has always treated its users like they were friends and not the enemy. 
They didn’t seal the works up, or keep you out of the system monitor, or hide 
their documentation under an armadillo somewhere, or try to prevent you from 
doing easy add-ons, enhancements, or expansions. Apple didn’t force software 
people to buy an expensive development system. Instead, the Apple II itself is 
its own superb development tool. There’s no fancy modules or other restraints 
that keep anyone from getting into the Apple support business. In fact, the widest 
possible number of Apple hardware and software suppliers was encouraged 
from the start. And the “our engineering department not only knows best, 
but they are God" attitude of other manufacturers is simply not there 
with Apple. 


The garbage-to-good ratio of Apple software is skyrocketing. The quantity of 
truly astoundingly atrocious Apple software is now running at least a thousand 
times ahead of the useful and reasonable stuff. And, it’s getting worse. 

Garbage software fails to use the unique Apple resources to the utmost. This 
type of software may be as snotty as most of the dino stuff, It may use fancy 
packaging and/or expensive promotion to try and make up for sloppy and 
poorly thought-out coding. Garbage software is usually locked, so that the user 
cannot back up or modify the program to suit his own needs. It is usually slow 
and awkward to boot. Garbage software also usually demands oddball codings 
and disk formats that guarantee incompatibility with everything else. 

Garbage software is caused by people who are greedy, sloppy, dumb, inex- 
perienced, in a hurry, or all five. Garbage software is not user oriented. It is 
‘overpriced. It has miserable error recovery. It tries to solve some small specific 
problem, rather than being a generalistic tool that can handle a broad class of 
problems. Garbage software steals the ideas of others, but can only come up 
with a second-rate result at best. It attacks problems that not only do not need 
solving, but which shouldn’t be solved at all with a computer. 

Please, if you are going to write this sort of trash, go get yourself a different 
brand of personal computer. We don’t need you and we definitely don’t want 
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Any attempt whatsoever at copy protection will hack off and inconvenience 
your legitimate users and it will dramatically increase the number of bootleg 
copies of your program in circulation. It will also price your program out of the 





marke! 


A user of software demands the absolute right to make backup copies of 
everything he buys, and must have the right to examine and modify all coding 
in that sofware so һе can meet his own needs. These are mandates. 

The big thing about copy protection is that it doesn’t. A year's effort bya 
crackerjack military cryptography team can usually be undone in fifteen 
minutes, between Klingon zappings, by your average fourteen-year-old. And, 
morality and economics aside, опе fact stands out . . . . 

Undoing copy protection is fun! 

Not only is it fun, but cracking the uncopyable is about the most challenging 
and most rewarding thing that you can possibly do with your Apple. And, the 
things you learn along the way are exactly the skills that you will need to become 
а iealiy ыса programmer. So, | guess we should all be thankful for the copy- 
protection peopie since they are giving us all this fascinating entertainment and 
sapere aig al ап unbeatable price. 








Introduction 9 














Today’s best and brightest Apple programmers are stumbling around in the 
dark. Proof of this is that a program with a Peelings rating of “АА” today barely 
earns a “В” next year, and drops to a “D” or unfit-for-use “F” the next 

Surely, by now, the message is in: it is absolutely impossible to write a great 
program in BASIC. Pascal, of course, is so bad that it is beyond the pale. Great 
programs must be written either wholly or in part in machine language so they 
can use Apple's resources to the utmost, at the fastest possible speed. Check 
Sofitalk’s top thirty. At this writing, thirty out of thirty are either written totally 
in machine language or make extensive use of machine-language sequences. 

It's scary to think of what a really good programmer, who truly understands 
his Apple, will be able to do with this machine. It hasn't happened yet, but watch 
out. It is only a matter of time. 


-.... 


We аге only now beginning to find out about some secrets of the Apple that 
everybody should have known about way back in 1977. For instance, we know 
now that we can have many different fonts of upper- and lower-case characters 
without using special hardware. We know that we can easily do an 80-character 
line with zero additional hardware, and that lines above a hundred characters 
are possible. We know that it is easy to quadruple the HIRES virtual resolution 
of the Apple. 

We know, of course, that there are hundreds of colors available either in 
HIRES (high resolution) or LORES (low resolution). We also know that we can 
mix and match HIRES, LORES, and graphics anyway that we like—anywhere on 
the screen. We know that we can do an exact, jitter-free, software lock to video 
timing for video wipes and precision light pens. Once again, these require no 
special hardware. And, of course, we know we can gently and legibly scroll the 
characters up the screen. We know that the early graphics mappings were much 
slower than necessary. And, we know our Apple can directly interface robotics 
and appliance controls—again, without special hardware. ; 

The big question is: “How much don't we know that we should have known 
back in 19772” 





This Enhancing Your Apple И® series is intending to try and bring everybody 
up to 1977. We want to try and understand what we really have in the Apple 
|, and what its real capabilities and limits are. 

Each enhancement is designed to show you something about some small 
corner of your Apple. While a typical enhancement will combine some simple 
new hardware with a machine-language driver or two, just about anything at all 
is likely to crop up. We have tried to mix simple and advanced enhancements 
together, so there will be something here for you, regardless of how much Apple 
experience and expertise you now have. 

Wealso have “unbundled” everything for your convenience and cost savings. 
Each enhancement is in four pieces. The first part of an enhancement is the 
complete story and listings here in this volume. Secondly, there is a companion 
diskette you can order using one of the cards in the back of the book. This 
diskette includes copies of all the code used in this volume and more. Machine- 
language codings include full source documentation under the Apple Assembler, 
while BASIC programs include full documentation. Naturally, you are free to 
copy, adapt, and modify this standard DOS 3.3 diskette to your heart's content, 
so long as you do so only for your own use. 
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Thirdly, there is a parts kit you can order that includes everything you will 
need to make all of the hardware modifications involving all the enhancements 
in the entire book. Lastly, and most important, there is also a feedback card. This 
card is needed for your participation in some of the enhancements. It also 
registers your name for updates and corrections, and it "closes the loop” so we 
can offer the best possible Apple enhancements in future volumes. 

Should you be interested, we will add an on-line update and bulletin board 
service to this feedback process. Let us know if you have a modem and want 
to participate. 

Taking a quick look at this volume, we start out with a pair of simple g/ompers 
that anyone can build. These solve completely the video changeover-switch 
hassles that you might have when using an rf modulator. Enhancement 2 is а 
software color Killer. A plug-in reversible hardware mod lets you eliminate all 
color fringes from black and white high resolution (HIRES) displays under soft- 
ware control. You can now combine color and black and white displays in the 
same program without any set adjustments. 

The real heavy of this volume is Enhancement 3. Here we find a method for 
tearing apart someone else's machine-language program that is astonishingly fast 
and super easy. It may take you years to fully explore and fully comprehend the 
implications of this single enhancement. 

Another heavy appears in Enhancement 4. We add a lone wire here to give 
you a way to exactly lock your programs to video timing. And, we mean exact. 
The locking is done jitter free, which opens up bunches of new applications, 
such as video wipes and precision hardware-free light pens. 

Want to mix and match HIRES, LORES, and text anywhere on your Apple 
screen? This is trivially easy once you master Enhancement 5. We also see how 
to tap the hundreds of available LORES colors in this enhancement. A compan- 
ion hardware mod called a glitch stomper appears as Enhancement 6. This опе 
makes displays that switch modes on screen operate even better. 

How about a gentle scroll, where the characters move smoothly up the screen 
rather than jumping up illegibly like they do now? This one’s done in Enhance- 
ment 7. It's super smooth, and completely glitch free. The final enhancement 
in this volume shows us how to pick up hundreds of different HIRES background 
colors, and how to put them down seven times faster than you might think 
possible. 

That’s about it for Volume Т. But, we have some really great stuff on tap for 
future volumes. A sneak preview appears at the end of this volume. This series 
is open-ended. As long as there are new things to learn about your Apple® and 
new ways to do them, we will try and show you how to do them. 

Oh, yes. Some legal beagle somewhere will probably get bent out of shape 
if I don't tell you that Apple is a registered trademark of some outfit in California 
whose name | don't recall just now, and that everything here is pretty much my 
own doing, and is done without Apple's knowledge or consent. 


Dow LANCASTER. 
Summer 1982 


This book is dedicated to "IT" 
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TWO GLOMPERS 


Here’s two different ways to elimi- 
nate the hassles caused by the 
changeover switches оп rf 
modulators. One glomper is porta- 
ble. The other is more or less per- 
manent. 


TWO GLOMPERS 


Have you ever been infuriated by that #$%# & changeover switch on your 
Apple's гї modulator? 

If you can find a flat place to stick it on the back of your ty, it's stuck there 
for good. If you can't, the switch quickly does a Kamakazi act, strangling itself 
on its own leads. And, this switch is very difficult and inconvenientto move from 
tv to tv. 

This changeover switch is totally useless. It doesn't even do what it is intended 
to do, since you can easily leave a built-in antenna in place and radiate your 
video all over everywhere. 

Here are two much saner antenna g/ompers that you can use instead. Either 
glomper version will quickly and easily fit any tv. They are cheap and simple 
enough that you can build lots of them. 
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Most rf modulators provide a phono plug input to the changeover switch. This 
phono plug fits a standard RCA phono jack. Both glompers start with an RCA 
phono jack and adapt it so that it is super easy to connect to your tv. 

Our glomper of the first kind is shown in Fig 1-1. This one mounts a phono 
jack on a clothespin tv antenna connector. This style glomper is best when you 
are using your Apple on lots of different tv sets at different times, or if you want 
to quickly switch between sets. 





Glomper о! the first kind is made Irom а phone 
Ї lack and а ciolhespin connector. Use it if you 
often change or tee! different i's 


Fig. 1-1, A glomper of the first kind. 


The glomper of the first kind is also very useful if you are buying a color tv 
and want to take your Apple to the store in order to compare lots of models to 
see which handles Apple video the best. 

Here аге the parts you will need for a glomper of the first Кіпа... . 


PARTS LIST FOR A 
GLOMPER OF THE FIRST 
KIND 


() Clothespin-style tv 
antenna connector. 


() RCA phono jack, 
vertical pc-mount style. 

() No. 22 stranded 
hookup wire, insulated, 
2 inches long. 

() Solder flux (optional). 


() Short piece of 
electronic solder. 





And here's the tools you will need to build either style glomper 
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INSTRUCTIONS FOR BUILDING 
GLOMPER OF THE FIRST KIND 


1. Try to fit a RCA upright pc phono jack to the two holes in the 
clothespin antenna connector as shown. One hole is in the 
metal and one is in the plastic 


If the center connection of the phono jack interferes with the 
plastic handle, remove some of the plastic as shown. Use a 
knife, a file, or simply melt the plastic with a soldering iron as 
needed. 





SOLDER Қ 
С 2. Strip 1/4 inch of insulation from both ends of a 2-inch-long 


piece of No. 22 stranded wire. 


Solder one end of this wire to the center conductor of the 
phono jack. Make sure the phono plug fits after soldering. 


3. Carefully and throughly clean both the phono jack and the 
clothespin connector at the point where they are to be 
soldered together. Add a drop of super-safe electronic solder 
flux if it is available. 


Solder the phono jack to the antenna clothespin connector as 
shown. Use a soldering gun or a medium (100 watt) soldering 
iron. 


4. Gently crimp the unsoldered ear of the phono jack against 
the plastic of the clothespin connector. 


Be sure the jack has cooled before you do this. 


5. Carefully clean the other side of the clothespin connector. 
Add a drop of super-safe solder flux if it is available. 





Solder the free end of the stranded wire to this side of the 
clothespin connector. 





6. Flex the clothespin a few times to be sure it works smoothly. 


CLIP TURNED OVER НЫ 
Remove any remaining solder flux. 







BE SURE 
d за? пт, This completes your assembly. 
e — 
p- VHF Tovar 7. To use your glomper, plug the pin plug on the rf modulator 
cable into the jack on the glomper, and clip the glomper on the 


proper antenna terminals. 


ALWAYS REMOVE ALL OTHER OUTSIDE AND INTERNAL 
ВС ан ANTENNA CONNECTIONS WHEN USING THIS GLOMPER! 
ВЕ MODULATOR 





Fig. 1-2. How to build а glomper of the first kind. 

















p 
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TOOLS NEEDED TO BUILD 
EITHER STYLE GLOMPER 


() Needle nose pliers | 
() Diagonal-cutting pliers 
() Wire stripper 


0) Soldering gun or 
medium soldering iron 


(3 Ink eraser or steel wool 


() Terminal crimper 
(optional) 


0) Small vise or clamp 





Construction details are shown in Fig. 1-2. You mount the phono jack on the 
plastic handle of the clothespin connector. Be sure to use a stranded wire 
between the center of the phono jack and the other arm of the clothespin. Solid 
hookup wire will soon break if you flex it too often. 

You will also want to carefully clean both the phono jack and the clothespin 
connector before soldering. This can be done with an ink eraser or steel wool. 

Гуси have some, a drop of "super-safe" electronic solder flux will make things 
much easier. Do NOT use any other type of flux! 





Glomper о! the second kind is made from арһого: 
Jack and spade lugs Use this glomper for more 
permanent connections. 





Fig. 1-3. A glomper of the second kind. 


Our glomper of the second kind is shown in Fig. 1-3. This one is designed to 
be permanently connected to a tv. It is nothing but an RCA phono jack and two 
stranded wires ending in spade lugs. Here's the parts you will need . . . . 


PARTS LIST FOR A 
GLOMPER OF THE SECOND 
KIND 





() RCA phono jack, () Мо. 22 stranded 


vertical pc-mount style. hookup wire, insulated, 
5 inches long. 


( ) Crimp-on spade lugs (2 


needed () Short piece of 
€ ) Solder flux (optional). electronic solder. 
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STRIP, CRIMP, 
AND SOLDER 





2 


STRIP 


GLEAN, CRIMP, 
AND SOLDER 








BE SURE 
TO MATCH 


б UHF ТО UHF 
окт 
Nail 
EN 







ов 

VHF TO VHF 
(SUP-R-MOD IS A 
UHF MODULATOR) 


CABLE FROM 
RF MODULATOR 




























INSTRUCTIONS FOR BUILDING 
GLOMPER OF THE SECOND KIND 


4. Cut two pieces of No. 22 stranded hookup wire 2% inches 
long and strip % inch of insulation from each end. 


Crimp and then solder one spade lug to опе end of each wire. 
2. Carefully polish the inside of one leg of an upright pe phono 
jack. Then roll one leg over onto the free end of one of the 


wires 


Add a drop of super-safe solder flux if available and solder wire 
to jack as shown. 


3. Solder the free end of the remaining wire to the center con- 
ductor of the phono jack. 


4. Carefully inspect the wiring to be sure there is no short bet- 
ween the outside and the inside of the phono jack. 


You might like to bend the remaining leg of the phono jack in- 
ward for better appearance. 


5. Twist the two leads together six or seven times and arrange 
the lugs as shown. 


This completes your assembly. 

6. To use your glomper, connect the spade lugs to the tv's 
antenna terminals. Plug the pin plug on the rf modulator cable 
into the jack on the glomper. 


ALWAYS REMOVE ALL OTHER OUTSIDE AND INTERNAL 
ANTENNA CONNECTIONS WHEN USING THIS GLOMPER! 





Fig. 1-4. How to build а glomper of the second kind. 


Complete construction details are shown in Fig. 1-4. Again, be sure to use 
stranded wire, carefully clean before soldering, and use a drop of “super-safe” 
flux, if you have it available. 

If you have several of your own tv sets in use, put a glomper of the second 
kind on each one. 

Be sure to connect the output of a uhf rf modulator (such as the SUP-R-MOD) 
to the uhf antenra terminals, or the output of a vhf modulator (some others) to 
the vhf antenna terminals. 

Note also that there are two RCA jacks on the SUP-R-MOD. The one you 
want goes down into the rectangular shielded box. The other one is not normally 
used and does notoutput any rf signal. It pays to label these two jacks "RF OUT’ 
and “VIDEO THRU” by writing on the inside wall of your Apple with a Sharpie 
or similar heavy pen. 
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Regardless of which style glomper you use, please obey this гше... . 


DO NOT EVER CONNECT THE RF 
OUTPUT OF AN APPLE SYSTEM 
TO А BUILT-IN ANTENNA, AN 


OUTDOOR ANTENNA, OR A 
>> | CABLE TV LINE, 





If you are using both an outside antenna and a glomper, you should put the 
Outside antenna line опа clothespin connector as well. If you have cable service, 
always unscrew the cable connector before using your Apple. 

A glomper of either style must be used with an rf modulator. Just because the 
Apple's baseband video output jack is also a Phono jack, don’t expect any useful 
results if you try to feed raw video into the antenna terminals of a tv set. While 
you might actually get something on the low channels if you try this, іп по way 
will the display be stable or useful, 

There is one other minor use for your glompers. Many of the music synthesiz- 
er cards output via a phono jack but can directly drive a speaker. If your speaker 
enclosure has a pair of screw terminals on the back, just use either style Вотрег 
to get from the music card to the speaker @ 


A complete set of all parts needed 
10 build two glompers of each 


style is included in the companion 
рап kit to this volume. 















Enhancement 


PROGRAMMABLE 
COLOR KILLER 


A simple, cheap, and reversible 
hardware modification that elimi- 
nates color fringes on text and 
removes unwanted color lines in 
HIRES displays. You now have a 
choice of black and white оғ color 
display under program control. 


PROGRAMMABLE COLOR KILLER 


Did you ever wish that you could eliminate those color fringes on Apple’s 
HIRES text displays? Or, be able to get rid of the vertical color lines that some- 
times mess up an otherwise stunning white-on-black HIRES display? Or, be able 
to do LORES special effects, where you switch from colors to grey patterns and 





it’s going to cost you. Around $1.10 and 15 minutes of your time. 

If both of these are within your budget, you can easily add your own software- 
controlled co/or killer. The mod will work on any but the oldest revision “0” 
Apples, and if you are careful, it will be completely reversible and wan't void 
your warranty. 

After the mod is completed, a single command inside your program can give 
you a choice of color or true black and white displays on your color tv or color 
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monitor. The software control commands are either a simple POKE or a BIT test 
and may be done.in any language. The color killer shuts off on an autostart reset 


and stays disabled until you activate it, so it stays invisible until you want it. 
Let's do it. 


What is a color killer? 


All color television sets have a built-in circuit called a color killer. The color 
killer decides whether the program material is being received in black and white 
or full color. If it is receiving a black and white signal, then the color decoding 
circuits are turned off. This keeps annoying color lines, snow, and fringes out of 
black and white program material. 

Fig. 2-1 shows us how the color killer inside your color tv works. In a typical 
color video signal, either from a tv station or from your Apple computer, there 
is a color burst following each horizontal sync pulse. This color burst usually 
consists of 8 cycles of a 3.58-megahertz sine wave. When present, the color 
burst is used to provide a reference for use by the color decoding circuitry 
inside the television. This arrangement lets the circuitry tell one color from 
another. 






соков PROGRAM 
ue VIDEO 
үп a typical color signal, a color burst is provided 
оп the “back porch” of tne horizontal sync pulse. 
‘This burst provides a color reference and deac. 
tivates the Color killer, allowing a color display. 





NO COLOR RET PROGRAM 
BURST Де VIDEO 
In black and whit rideo the color burst is absent 
Tas pitas ee ca wer wp oan ийг 
ЗЭВ Dulches tom blach ad wile ому copie. 


PULSE 7-7) 





Fig. 2-1. How the color ki 





which is present in all color sets, can tell color 
from b/w video. 





The color killer looks for these bursts, and if it doesn’t find them, it defeats 
‘ocessing so that the set displays a black and white picture with no 
color fringes. If the burst is present, the color killer lets the color processing 
circuits do their thing, and you get a full color display. 

Unfortunately for us, the color killer in your set is rather slow. It takes a fraction 
of a second for it to work. The reason for this is that in a fringe reception area 
where you get a weak or snowy picture, a color killer too fast or too sensitive 
would continuously switch from black and white to color and back again as the 
signal quality varied. This would really foul things up. 

What this means is that, as Apple people, we can only expect a color killer 
гой. М! 't expect it to switch back and forth during а single field 
10 give Us, Say, iuli-coior mixed graphics with a true black and white four-line 
п. This we cannot do. But we can easily switch from black 
and white В full colon алд back again, anytime we аге willing to have the entire 
screen be one or the other. 
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The modification 


As Fig. 2-2 shows us, all but the earliest Apples have an automatic color killer 
Circuit built into them. This circuit (Fig. 2-2A) consists of a 2N3904 transistor 
(Q6) and a 4.7K resistor (R27). Whenever you are in the full text mode, the point 
driving the 4.7К resistor goes positive, which turns Q6 ON, which shorts out the 
color-trimming circuit. The short, in turn, eliminates the color burst from the 
‘output. In anything but the full text mode, the point driving the 4.7K resistor goes 
low, which turns transistor Q6 OFF, allowing full color. 

This existing hardware color killer on your Apple works well with most better- 
grade color tv's, but it only works on full text displays done the “old” way. It 
will not work on a text display on either HIRES page or on mixed graphics. Nor 
will it work on a HIRES graphics display that is supposed to be all black and 
white. Nor can it work on a LORES display. 

Fig. 2-28 shows us how to add one resistor to give us software-controlled 
color killing. We add a second 4.7K resistor so that it also goes to the base of 
transistor Q6. This resistor comes from the source of AN1. Make ANT high, and 
you kill the burst and get true black and white displays. Make AN1 low, and you 
get full color on everything but text displays. 


ов 
it COLOR KILLER 
(A) Color killer circuit. ? ы 


Existing color killer circuit in your Apple works ому 
in fulltext mode. 


(8) Circuit modification. 


Now resistor gives you software controlied color. 


Fig.2-2. A single resistor is all you need to add a software color killer. 
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Rather than grab АМТ at the game paddle, we get it {гот its source, ріп 10 
of F14. This prevents accidental pull-outs when the game paddles are removed. 

The autostart ROM always drives AN1 /owon a cold start reset. This makes 
the color killer invisible until used, Note that there are errors in some early Apple 
тегегепсе manuals involving what happens during a cold autostart reset. | have 
found that what really happens is that ANO алд АМ! go /owand AN2 and AN3 
во high ona cold autostart reset. You should correct pages 36 and 143 of your 
Apple reference manual if they do not agree with this. 

Logically, this is a моя circuit because switching to the text screen OR turning 
annunciator АМТ ON activates the color killer and puts the colors OFF. 


Building it 


Here's the parts you'll need .... 


PARTS LIST FOR 
SOFTWARE COLOR KILLER 


() 16-contact quality DIP 
socket, machined-pin 
style. 


() Pin from machined-pin 
DIP socket. 

() 4.7K, 1/4-watt resistor 
(yellow-violet-red). 

() Short piece of 
electronic solder. 





And, here аге the tools you will need . . 


TOOLS NEEDED TO BUILD 
SOFTWARE COLOR KILLER 


() Needle nose pliers 

() Diagonal-cutting pliers 

() Wire stripper 

() Small soldering iron, 35 
watt 


() Any old 14- or 16-pin 
DIP integrated circuit 


() Small vise or clamp 





Fig. 2-3 shows us the area of the Apple's board that we are going to work with. 
The color killer transistor Q6 is located above integrated circuits F13 and F14. 
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(D ADAPTER MADE FROM 
PREMIUM DIP SOCKET APPLE II 
GOES IN F14. MAIN BOARD. 


И. 
HO TRIM 





rin зоог ADAPTER @EXISTING 9334 


CONNECTS ТО Q6 ОН 7415259 
END OF R27 THRU REPLUGS 
NEW 47K SERIES INTO ADAPTER 
RESISTOR 


Fig. 2-3. Pictorial shows color killer hardware additions. Single pin socket at Q6 allows 
easy removal. 


See the APPLE board parts locations sidebar located at the end of this en- 
hancement for more details on how to locate a part on your Apple’s main circuit 
board. There is a grid numbered from 1 to 14 across the bottom, and lettered 
A through К up the left-hand side. Letters “С” and “1” are omitted to save on 
confusion. Location “Ғ14” is the place where the “Р” row and the “14” column 
cross. Note that F14 is NOT the fourteenth component in that row. Some ICs 
are larger than others and other locations may not be used at all. Only the grid 
location counts. Note that the numbers across the top of the circuit board (not 
shown) refer to the 1/О slots and have nothing to do with the grid. Note also 
that there are other resistors and transistors elsewhere on the circuit board. 
These have nothing to do with the color killer and must not be altered. 

Your mod consists of adding an adapter socket to F14 that routes a 4.7K 
resistor from АМТ to a new single-contact jack added to the transistor end of 
R27. Fig. 2-4 gives the assembly details. Be absolutely certain you are using a 
premium 16-pin DIP socket with machined-pin contacts. These may safely be 
plugged into another DIP socket without damage. Also, be certain to keep all 
solder off of the actual part of the pins that must fit the socket at F14, and be 
careful not to melt the plastic part of the socket. 

Should you ever want to undo the color killer, just reverse the above proce- 
dure. If you ever need some warranty repair, carefully untack the single pin 
socket as well, and clean up any remaining solder with a solder sucker or 
desoldering braid. Strictly speaking, the mod does void your warranty, but you 
can easily disguise the fact that it ever was made. 

Always be careful when you insert or remove anything. See that the color 
killer mod stays in place. А dab of hot glue, silicon rubber, or other “semi- 
permanent’ sticky stuff might be a good idea here to hold the killer socket to 
the pc board. Be careful, of course, to keep any gunk out of the socket pins. 

Note that a cold start RESET using the autostart monitor will also turn the color 
killer off, but that an autostart RESET to some BASIC program usually will not. 
Thus, the color killer will normally come up as OFF if you don’t mess with it, 
just like it wasn’t there. 
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Here's how to install your Software color killer... 










INSTALLING THE 
SOFTWARE COLOR KILLER 









+ Turn the power off and 16-pin socket into the 
unplug both ends of the Apple mainframe at 
Apple power сога. Ғ14. Be sure that the 


Remove the 7415259 or resistor points away 


5 белү from you and that the 
9334 integrated circuit 
at F14, using an IC notch on both socket 


i d IC points towards 
Buller if you have one an 
available. the keyboard. 


. Plug the floating resistor 
3. Plug the 745259 or lead io the ee 
9334 into the color желе еш 
s id ШИНЭ Be using needle-nose pliers, 
и по! 
both the socket and the Reconnect the power 
ІС point in the same cord and apply power. 









м 









м 








+ 








" Run the COLOR KILLER 
шеп. DEMO program for 
4. Plug the color killer's checkout. 










INSTRUCTIONS FOR BUILDING 
COLOR KILLER 


1. Take a single ріп froma machined-contact socket and bend 
it as shown. If you destroy a socket to get one of these pins, 
melt the pins out rather than stressing them. 


Plug the 4.7K resistor into the Single pin socket as a temporary 
“handle.” Then, tin only the bent part of the socket by applying 
a very small amount of solder. 


Do NOT solder the resistor to the socket! 





2. Find the end of resistor R27 nearest Q6 on the Apple main 
board and tin the lead of R27 here by applying a small amount 
of solder. * 





Fig. 2-4. How to build your color killer, 





BEND UP 90° 
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ват ал Then, reflow solder the “tail” of the single pin socket to the Q6 
end of resistor R27. The tail should point towards the 
keyboard. 


Remove the resistor “handle” after the solder cools. 





3. Plug any old nonvaluable 16-pin DIP integrated circuit into 
the 16-pin machined-contact pin socket. This will keep the con- 
tacts aligned should the plastic soften. 


Identify pin 10 by inking the plastic. 


PN ap Note that this MUST be the type of premium socket that has 
м small machined-pin contacts that аге safe to plug into another 
Socket. 


Secure the socket in a small vise. 





4. Cut both leads of the new 4.7K resistor to 7/16 inch length. 
Form a bend and a loop in one resistor lead as shown. Secure 
the resistor in this position somehow. 


Solder the resistor loop to pin 10 of the socket, EXACTLY as 
shown. 


Be sure that no solder gets onto the part of the pin that must 
plug into the Apple, and that there are no shorts to adjacent 
pins 9 and 11. 





5. Remove the nonvaluable IC and set it aside and out of sight. 


Position the socket as shown. Then bend the remaining 
resistor lead downward as shown. 


This completes the assembly. 


BEND DOWN 90* 


V -28 
dime 


Refer to the text for installation and checkout. 

















Fig. 2-4 Cont. How to build your color killer. 
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Here's how you use your software color killer . . . 


USING THE 
SOFTWARE COLOR KILLER 


From machine language — 
BIT 5С058 turns killer ON 


BIT 5С05А turns killer OFF 
From either BASIC — 


РОКЕ — 16293,0 turns killer ON 
POKE —16294,0 turns killer OFF 





There could possibly be a conflict between the color killer and anything else 
that is plugged into the game socket that uses АМТ as an output. Note that there 
would be no conflict on a text display or on a display routed to a black and white. 
monitor. There may not be a conflict if the other use of ANT is brief or rare, or 
if it takes place in the text mode. Naturally, if you must have AN1 for a conflict- 
ing use, you can always remove the socket and its resistor. 

While а BIT test is the most “proper” way of switching AN1 from machine 
language, any old mode that addresses these locations, such as LDA 5С058 or 
а СОЗА, тау be used. 

ut... 


Do NOT disconnect the color killer 
resistor without removing the DIP socket! 


A floating resistor lead can cause damage 
if it happens to hit anything. 





Program 2-1 is an Applesoft demo program that makes a pretty HIRES picture 
for you and alternately switches the color killer OFF and ON every few seconds. 
Watch particularly the effect on the slightly slanted lines in the middle of the 
image and the color fringing on the mixed graphics. Besides the Applesoft 
language, Program 2-1 needs the color killer hardware modification as described 
in this enhancement. 

If you hand load this program, be sure to include the space following the 
“ОМ” in line 450. Note also that a color killer ON should give you black and 
white and a color killer OFF should give you a full color display, 

You can use this demo to test your programmable color killer. The program 
works by first setting up a HIRES picture in the mixed graphics mode and adding 
some color blocks. Then, it turns the color killer OFF by poking АМТ to a zero, 
and writing the word “OFF” to the text area. It then delays for a few seconds, 
pokes ANT to a one, and writes the word “ON.” The process keeps repeating 
till you end the program with a CTRL-C or a RESET. 

Some very old, cheap, or otherwise scungy color tv sets may ignore the color 
burst and do their color killing based on whether (Негев lots of energy in the 
“color band.” Since Apple always has lots of energy in the “color band,” these 
sets will ignore any color killing commands. On a set like this, the old hardware 
color killer won't work either. On these 5615, you are stuck with the old method 
of manually backing all the color controls off. 


i 
| 
! 








Programmable Color Killer 25 














PROGRAM 2-1 
COLOR KILLER DEMO 








LANGUAGE: APPLESOFT NEEDS: COLOR KILLER HARDWARE 
MOD OF ENHANCEMENT #2 


АА 


COLOR KILLER 
DEMO. 


VERSION 1.0 
(11-4-81) 
BY DON LANCASTER 


AND SYNERGETICS 


ALL COMMERCIAL 
RIGHTS RESERVED 


* 
* 
* 
* 
* 
* 
* 
4% COPYRIGHT 1981 
* 
* 
* 
* 
* 
* 
* 


"Л СЫ 


COLOR KILLER DESCRIBED 
IN ENHANCING YOUR 
APPLE II, VOLUME 1. 


HOME : REM CLEAR SCREEN 
HGR : REM HIRES ON 

POKE - 16301,0: REM MIX GR 
APHICS 





ECOLOR- 3: REM DRAW WHITE 


HPLOT 70,40 TO 120,40 TO 123 
4110 TO 168,110 ТО 171,40 ТО 
221,40 ТО 221,140 ТО 70,140 ТО 
70,40: REM DRAW FIGURE 


HCOLOR= 1:H = 90:V = 58: GOSUB 
500 

HCOLOR= 2:H = 90:V = 115: GOSUB 
500 

HCOLOR= 5:H = 190: GOSUB 500 




















А TT a 
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PROGRAM 2-1, CONT'D... 





330 = 86: GOSUB 500 
340 = 58: GOSUB 500 
350 HPLOT 90,86 TO 99 


486 TO 99,96 ТО 90,96 ТО 90, 
87 
360 REM DRAWS SIX COLOR BLOCKS 


400 VTAB 21: HTAB 12: PRINT "COL 
OR KILLER IS ";: REM PRINT 
MESSAGE 


410 POKE - 16294,0: REM TURN K 
ILLER OFF 


420 NORMAL : HTAB 28: PRINT "OFF 
";: REM ТЕХТ 








430 FOR N - O TO 6000: NEXT : REM 
STALL 5 SECONDS 


440 РОКЕ - 16293,0: REM TURN Қ 
ILLER ON 





450 INVERSE : НТАВ 28: PRINT "О 
М ";: NORMAL : REM TEXT 


460 FOR N = 0 TO 6000: NEXT : REM 
STALL 5 SECONDS 


465 IF PEEK ( - 16384) > 127 THEN 
РОКЕ - 16368,0: PRINT : PRINT 
"RUN MENU": REM EXIT ON KP 


466 REM REPLACE :PRINT: WITH 
:END IN 465 IF AUTO MENU IS 
NOT IN USE. 


470 GOTO 410: REM DO IT AGAIN 


500 FORN - 0 TO 9 

510 HPLOT H,(V + N) TO (н + 10), 
(V + N) 

520 NEXT : RETURN : REM SUB TO 
DRAW BOXES 
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APPLE BOARD PARTS LOCATIONS 








Parts are located on the Apple main circuit board by use of a grid system . . ~ 


10 CONNECTORS ARE 
NOT PART OF GRID 


MCI sti 
за акар г моче 


et 
7578 502 071 —" 


РЕТ FREE МЕРЕТ PE SER PRES TTY 
‘RF MODULATOR) 


(POWER SUPPLY) 


et ee 
lee Dn 


There are fourteen columns in the grid numbered from 1 to 14. Each numbered column goes 
from front to back. There are nine rowsin the grid lettered from AtoK. Each numbered row goes 
from leftto right. Letters С and | are omitted to prevent mixups. 

An integrated circuit, ог IC, is located by finding the grid crossing that it is nearestto. Ifthe IC 
isa big one, the lowest grid crossing number is used as the location. 

For instance, the game paddle is located at J14. The 6502 microprocessor is said to be lo- 
cated at H6, although it also takes up grid locations H7, H8, and НЗ. 

If the Apple is still in the case, you cannot see the grid numbers that run from leftto right since 
these are at the front of thecircuit board under the keyboard. Instead, use row “С” and count the 
fourteen integrated circuits from left to right. Integrated circuit СТ is a 7415153, while integ- 
rated circuit C14 isa 741532. 

Note that not all rows are completely filled, and that some ICs are bigger than others. Thus, 
the IC in grid lecation F14, which is a 7415259 or a 9334, is only the tenth or eleventh device 
from the left, depending on the version of your Apple. 

Note also that the row of numbers along the top of the board are the slot numbers for the VO 
sockets and have nothing to do with the grid callouts, 


REMEMBER—To find a given location, count GRID POSITIONS and not devices. 
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Our new software color killer only kills the color subcarrier at one point in 
the circuit, unlike Revision 7 and later Apple versions whose hardware color 
killer nails the subcarrier twice. Thus, the software color killer may be slightly 
тоге sensitive to the control settings. 

If you get some brief color flashes during the OFF times on a better grade set, 
this usually means the auto-color Circuitry in the tv is Aunting. Try backing the 
color controls off slightly or turning the auto-color switch on the tv OFF if this 
happens. Usually, a careful adjustment of controls and a touchup of the rf 
modulator video level at the Apple will completely eliminate any color flashing. 


On any reasonable set, you should get your choice of continuous color or 
continuous black and white, after some initial adjusting @ 


Тһе Applesoft program SOFTWARE 
COLOR KILLER DEMO is included 
in the companion diskette to this 


volume, 
The program is fully copyable. 





A complete set of all parts needed 
to build one color killer modifica- 


tion is included in the companion 
parts kit to this volume. 





Ld dedii 


——— АДИ 













Enhancement 






TEARING INTO 
MACHINE-LANGUAGE CODE 


This method of breaking down and 
understanding someone else's 
Apple Il machine-language pro- 
gram is — to say the least — 
unique. Here are complete details 
on how to rapidly "crack" both 
the form and function of any tough 
program. It takes only one-tenth 
of the time of orthodox methods. 


TEARING INTO MACHINE-LANGUAGE CODE 


Check into the top twenty Apple programs used today and guess what? At this 
writing, twenty out of twenty аге written wholly, or at least partly, in machine 
language! 

So, while BASIC language people are busy foisting computer literacy off onto 
the unwashed masses, and while Pascal people are stuffily trying to salvage what. 
few shards that remain of the once mighty computer science theocracy, and 





while FORTH people are out acting like spoiled brats . . ., while all of this is 
happening . 
Machine-language programmers are laughing to themselves all the way to the 


bank! 
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The evidence is іп and it is overwhelming. Cash on the line. If you want to 
write а classic program or a best selling program, it must be done either wholly, 
or in part, in machine language. 

Why? 

Because machine language is far and away the fastest running, the most 
compact, the most flexible, the most versatile, and the one and only language 
that most fully utilizes all of the Apple's resources. 

The only sure way to learn machine-language programming is to do lots of 
it on your own. But one thing that can help you a lot is to tear apart the winning 
machine-language programs of others to see what makes them tick. 

You might also like to modify someone else’s machine-language program to 
suit your own needs. Maybe you would like to find the scroll hooks in the HRCG 
High-Resolution Character Generator. Or perhaps you want to modify the origi- 
nal Apple Writer to output imbedded print format commands to your daisy- 
wheel. Or change FID to add your own “undelete Не” command. Or maybe 
you have to modify a printer driver to handle HIRES graphics dumps. Or you 
might need some stunning animation. Or want to know what makes an adven- 
ture tick. Or whatever. 

At any rate, if you brute-force attack someone else’s machine-language pro- 
gram and if the program is more than a few hundred words long, chances are 
it will take you a very long time to crack it to the point where you think you 
understand it. 

I'd like to share with you a method | use that will crack any unknown machine- 
language program astonishingly fast. The method does odd things odd ways, but 
ends up taking one tenth the time and one tenth the effort of any usual 
approach. 

We'll assume you already know and have done some machine-language 
Programming, and that the target program you want to tear into was written by 
an experienced and more or less rational programmer who didn't go very far 
out of his way to make things rough for you. 

Let's see what is involved. 


THE TOOLS 


First, we'll have to put together a toolkit. You should have a tractor-feed 
printer along with some heavy white paper, preferably 20-pound paper. Natural- 
ly, vou will also need a plastic 6502 Programming Card and, of course, the 6502 
Programming Manual. The following listing gives a breakdown of the tools you 
will need to effectively tear apart machine-language programs. 

You will also want all the usual Арр/е manuals, along with a copy of the Apple 
Monitor Peeled, and, if you сап find one, a copy of the old red Apple book. l'm 
also laboring under the delusion that you'll find Don Lancaster's Micro Cook- 
book, Volumes 1 and 2, of help. 

Try to get an Apple that has access to both an autostart ROM on а switchable 
plug-in card, and the old monitor ROM, without autostart, in socket F8 on the 
mainframe. This original ROM has the Trace feature, which was removed to 
make way for the autostart function. More importantly, ће “old” ROM gives 
you the absolute control that is needed to stop any program at any time for any 





Note that many newer programs will not let you drop into the monitor when 
Vou use the autostart ROM. Instead, they adjust the pointers so that they return 
to themselves on a system reset. Thus, an old ROM may be absolutely essential 
to let you view the target code. 
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MACHINE-LANGUAGE 
TOOLKIT 


48K Apple II, preferably with. 
an old ROM in mainframe 
and switchable autostart 
ROM on plug-in card 


Tractor-feed printer. 

Heavy white tractor paper. 
6502 Programming Card. 
6502 Programming Manual. 
All Apple manuals. 

Apple red book. 

Apple Monitor Peeled book. 


Lancaster's Micro Cookbook, 
Volumes 1 and 2. 


Roll of transparent tape. 


Case of page highlighters, in 
all available colors. 


Fine and regular felt-tip pens 
of matching colors. 


(2 Serendipity scratch pad. 
() What if? quadrille pad. 


() A quiet workspace. 
( ) The right attitude. 





If you really get into machine-language programming, this original firmware 
ROM is very, very useful. | suspect these ROMs may eventually become rare, 
but with 2716 ЕРКОМ5 now under $5.00, you can easily clone your own by 
adding a simple CS adaptor to ROM socket F8. 

You will want at least a 48K machine, and if there is extra RAM on plug-in 
cards, so much the better. The big advantage to having more RAM than the 
program needs is that you are free to add your own test and debug programs 
co-resident with whatever target program you are tearing apart. You should have 
both a cassette and at least one disk drive. The cassette can always save any 
image of any part of any program at any time, regardless of whether there is a 
DOS operating system there or not. Images on the tape can be split up and 
relocated as needed, letting you transfer them to disk at your convenience. Тһе 
cassette can also let you introduce very small “test” and "hook" programs into 
the darndest spaces. 

Now, off to the office supply. Get yourself a big roll of transparent mending 
tape—the kind you can write on. Then get two cases — yes, cases — of page 
highlighters. Throw away all the extra yellow ones, and get as many different 
colors as you can. Match each page highlighter with both a fine point and a 
regular felt-tip pen of the same color. 
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Don’t underestimate the importance of these page highlighters, This method 
starts out real stupid like, but you will be astounded when the truth and beauty 
of what's happening leaps out at you halfway through. The highlighters are 
absolutely essential! 

Get yourself some scratch pads as well. Label the little blank one "Serendi- 
pity" and the big quadrille one "What і”. 

You also have to have the right attitude, the right workspace, patience, persist- 
ence, curiosity, perversity, and a very distorted sense of humor for this method 
to work. 

It is extremely important that you do everything that follows hands-on and by 
yourself, Do not, under any circumstances, let someone else or the Apple help 
you with any tedious or dogwork parts. The method relies heavily on your 
subconcious putting together the big picture and sewing up the loose ends. It 
can only do this if it has access to everything that the tearing-attack method 
needs. Do the dull stuff yourself! 


THE FIRST RULE 


What can we expect to find inside a machine-language program? The working 
code for sure. But, besides that working code, we need files that go with that 
code. In most longer machine-language programs, the files take up far more 
room than the working code does. 


START 





Fig. 3-1. А "typical" machine-language program. 


Fig. 3-1 shows your “typical” machine-language program, which is just about 
as representative as your “typical” Apple owner or your "typical" rock. Any- 
way, we see that there are usually two main areas to a larger machine-language 
Program. These are the action and the bulk files. 

The action is the “гез!” part of the program that actually does things. The 
action, in turn, is made up of two different types of blocks. These blocks are 
called code modules and stashes. 

A code module is a chunk of working machine language code that does 
something. In most programs, most of the modules are subroutines, and are 
called as needed from a very short main program. The advantages of subroutines 
are that they break things down into small and understandable chunks and that 
they can be accessed from several places in the main program at once. 
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A stash is а short file that works directly with a module. The stash often follows 
immediately after the module that uses it. Typical stash entries might be a short 
ASCII string, a list of condition codes, or a table of indirect addresses. The stash 
holds values needed by the module that it works with. 

The bulk files are usually much longer than the stashes. Bulk files normally sit 
off by themselves and usually follow the action. An example of a bulk file might 
be a high-resolution character set. The action controls how and when the 
character codes in the bulk-file character set go on the screen. In a medium- 
sized adventure, the bulk files may contain the map, the script, the objects, the 
responses, the rooms, and anything else unique to one particular story line. Only 
the bulk file has to be changed to change the adventure. The action can often 
stay the same. 

In animated games or other programs that use the HIRES features, the bulk 
file may actually be the HIRES screen pages, or combinations of these pages 
with extra file space. 

If you are into very fancy machine-language programs, the action may, in fact, 
be an interpreter acting as a special-use language. The bulk files will then contain 
commands that are run under the action’s command interpretation. Zork is a 
classic example of this type of thing. In Zork, the action is a LISP-like interpreter 
specially written in compact and fast machine-language code. 

The absolute key secret to tearing into machine-language code is . 


THE 


Find out the STRUCTURE and the 
FLOW of any program, and most 
of the code will take care of itself! 


So, never, never, never start taking apart machine-language code on a line-by- 
line basis. This is a total waste of time and will take forever. 

Not to mention that it won't work anyhow. 

The whole trick is to find out the structure of the program. Separate each 
module of the program and then separate each file from everything else. You'll 
find out there are very powerful hidden indicators that will leap out at you when 
you look for them. These indicators will very rapidly break everything down into 
simple, obvious, easy-to-understand, and self-documenting chunks. 

Don't believe me? Let's try it and see. We'll use Apple's own HRCG High- 
Resolution Character Generator as a target program to show you how the 
method works and to illustrate key points. We'll go over the method in some 
detail, Later, we'll sum everything up in one checklist. НЕСС is available on the 
DOS 3.3 TOOLKIT diskette. 

You'll get the most out of what follows by actually doing each and every step 
using your own copy of HRCG as we go along. Then try the method on a target 
program of your own choosing. 


THE METHOD 


Ready? Here we go. 


GROK THE PROGRAM | 


You must be thoroughly familiar with what the program does and how it 
works before you start. Never try to crack a code until after you have used the 
program and really and truly know it. 











p 
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For instance, there's absolutely по point in taking apart Pyramid of Doom to 
try and find the shovel. If you can't find the shovel, you just aren't cut out for 
Adventure. But, you just might want to tear into it to find the last treasure you 
need to replace the treasure you have to destroy to get past a certain —uh— 
inconvenience halfway up the pyramid. In no way will your first tearing into 
Adventure tell you the last treasure is in the dressing room, but you'll learn a lot 
about machine language and machine-language programs as you go along. 

In the case of the HRCG, use the program and thoroughly explore all the 
alternate character fonts, and all the options of each and every mode of opera- 
tion. 

Know exactly what the program does before you try to tear into it. 

One limit to this, though . 


NEVER assume a program works in 
а certain manner or “has” to do 


Something in an obvious way! 





Thus, while you are learning how to use the program, and while you may think 
you have some good ideas on how the program works, reserve judgement till 
later. All your good ideas will invariably turn out to be 100% wrong. 

If you can, watch others use the program and look into their reactions of how 
the program works and what it does. You may be missing something totally 
obvious. Rap with others as much as possible. 


GO TO THE HORSE’S WHATEVER } 


Read every scrap of documentation that comes with the program, no matter 
how badly written or misdirected it may seem. Always ask around to see if the 
source code exists somewhere. Be sure to look into updates and revisions as 
well. It is infinitely easier to start with the original author's source code and work 
into the program, than to start with an unknown bunch of code and try to infer 
what the author had in mind in the first place. 

If there is no documentation or if it isn’t helpful, and if the original source code 
isn't available, keep checking. Perhaps others have torn into part of the code or 
have made modifications on their own that seem to work. Ask around at your 
club, school, computer store, bulletin board, or user group. If anything is avail- 
able that seems 10 help, try it. 

Anything else that can give you a clue to where the software author's head 
is and where he is coming from will be of great help. Maybe he publishes articles 
and stories. Maybe he has a series of programs out that can be of use. 

А few moments of asking in the right places can save you months of time. 

So, always check around. 


HAVE A LIMITED GOAL | 


Any genuinely experienced programmer will admit to-this rule . . . . 


A long program is NEVER fully 
debugged nor fully understood. BELIEVE <а 
Nor can И ever be. IT! 
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The entire DEW (Distant Early Warning) defense radar program was never 
tested. Not only was it never tested, the DEW program was so hopelessly 
complex that there was no possible way it could have been fully tested. Even 
if some test method existed, the probability of it passing any test was infinitely 
small. 

A good and clean program simply has most of its remaining bugs fairly well 
hidden and fairly well out of the mainstream. This only happens after the ninth 
or tenth revision. But rest assured, there are definitely still bugs there, lying in 
“deep cover’ and patiently waiting. 

What this says is that the original programmer did not fully understand nor 
fully debug his program. If he says he has, he is either lying or else hopelessly 
naive. Now, if he didn’t understand his own program, why should you? 

Thus, а goal “10 completely understand” some program is not only unreason- 
able, it is patently ridiculous. Instead, set yourself a reasonable and realistic goal 
for your first trip of tearing into machine code. Then, after you have set this 
realistic goal, simplify it till it is trivial. Then, simplify that. Then, think up some 
really dumb test of a small part of what is left. Something any idiot could hack. 
Maybe, just maybe, you will then be in the ball park. 

For the HRCG, let's use the goal of answering "Where are the scroll hooks?” 
The HRCG obviously has some sort of scroll in it, since it moves characters up 
the screen. The scroll on the version | received is abrupt and chunky, so it can 
obviously be improved. 

Or can it? 

Maybe it's not so obvious. Why would such a good program have such an 
ugly scroll? These are name-brand people working on this and chances are they 
fumed and fretted over things quite a bit. Better stick with our original goal of 
finding the scroll hooks. 

When you set your limited goal, don't become obsessed with it. The tearing 
method works by separating the known from the unknown as you go through 
the code. The method we will use demands a lot of apparently useless side trips. 

Concentrate only on your goal and you may never get there. 


FIND WHERE THE PROGRAM SITS | 


Before we сап go оп with our tearing attack method, we have to take time 
ош for a rather long, but most essential side trip. Ready? Here we бо... 

Where is the machine-language program likely to sit? A glib answer is some- 
where between $0000 and $FFFF, unless they are using memory mapping to go 
beyond 64K or unless they are swapping things back and forth to the disk. This 
assumes, of course, that the program is not self-modifying so that it changes itself 
through time. 

Figs. 3-2 through 3-6 show us some places we can put a program. We can 
divide these into /ow RAM, high RAM, and wherever. Let's check these in more 
detail. 





Low RAM 


Low RAM is heavily used. As Fig. 3-2 shows us, low RAM goes from hex 
$0000 through $07FF, or memory pages Zero through Seven. Most of this space 
is reserved by the Apple for “system” uses. Let's check this out on a page-by- 
page basis . . 

Page Zero is extremely valuable real estate for two reasons. The first is that 
the 6502 has a page Zero addressing mode that is shorter and faster than most 
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PAGES FOUR THROUGH SEVEN ARE 
THE TEXT AND LORES PAGES, 
THERE ARE ALSO 64 RAM 
LOCATIONS IN 8 GROUPS OF 8 
eae EACH INTENDED FOR ПО USE. 
(2047) PAGE THREE HOLDS THE DOS 
POINTERS AND MONITOR VECTORS 
AT ITS HIGH END. THE BOTTOM 
ОР THIS PAGE IS A POPULAR 
PLACE TO PUT PROTECTED 
AND MACHINE LANGUAGE CODE. 

LORES 
(PAGE ONE) PAGE TWO 15 THE KEYBOARD. 
INPUT BUFFER AND WORKS FROM 
THE BOTTOM UP. SHORT 
PROGRAMS CAN BE PUT AT ТНЕ 
TOP OF THIS PAGE, BUT A 
DANGER EXISTS OF A LONG 
KEYBOARD ENTRY PLOWING THE 
PROGRAM. 


PAGE ONE IS THE STACK AND. 
WORKS FROM THE TOP DOWN. 
SHORT PROGRAMS CAN BE PUT AT 
BUFFER THE BOTTOM OF THIS PAGE, BUT 
А DUAL DANGER EXISTS OF THE 
PROGRAM PLOWING THE STACK, 


STACK РА VICE VERSA. 
$0109 


PAGE ZERO HOLDS CALCULATED 





23 

50 | ponens ADDRESSES, ALL VALUES PASSED 
NN BETWEEN PROGRAMS, AND MOST 

$0000 SYSTEM CONSTANTS, THERE © 


© USUALLY МО ROOM FOR ACTUAL 
PROGRAM CODE HERE, ALTHOUGH 
MOST PROGRAMS WILL USE THESE 
LOCATIONS FOR STORAGE. 


Fig. 3-2. Low RAM memory map. 


other addressing modes. The second is that the two most powerful 6502 ad- 
dressing modes — indirect indexed and indexed indirect — demand pairs of 
address locations on page Zero. 

The Appie book shows how practically all of page Zero is used up one way 
or another by the monitor, the DOS, or either BASIC. For instance, the locations 
for the keyboard entry hooks and the print output hooks are stored as addresses 
оп page Zero, as are the screen formatting controls that set the height and width 
of the display. Other important page Zero locations convert line numbers into 
the base addresses needed to hit a certain line of video. 

We will see a list of these important page Zero locations shortly. The point 
here іс 


Practically all programs need a few 
locations on page Zero. 

Some of these are used to pass 
values into the monitor, to BASIC, 


ог to another part of itself. 
Other page Zero locations are 

used to hold calculated addresses 
for the indirect addressing modes. 





Thus, page Хао real estate is far too costly for program code. Instead, the 
available locations are used to pass values back and forth between the system 
and Wie Larger program, and to hold calculated address values. 

Sometimes a target program will reassign page Zero locations for its own use. 
For instance, if the target program is fully in machine language, it can borrow. 
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many of the locations "reserved" for Applesoft or Integer BASIC, since these 
locations will never be used. Monitor locations that serve oddball purposes can 
also be “redefined” provided that the monitor feature is never used, even by 
accident. 

Occasionally a very short machine-language sequence can be crammed into 
low values on page Zero, as was done with the original tone subroutine in the 
old red book. Even this got you in trouble when you switched to Applesoft. So, 
putting programs on page Zero is both dangerous and dumb, but it can be done. 

Another dangerous place to put programs is on page One. Page One is 
intended to be used for the stack. The 6502 uses a single stack that starts at 
location $01FF and builds down. This stack is shared by the monitor, the 
‘operating system, and the program itself. Important uses of the stack are to store 
the return address of a subroutine call and both return address and processor 
status on an interrupt. Advanced programmers might also use the stack as a 
temporary stash of a value or two, or might even manipulate the stack to alter 
the program flow. 

The stack rarely gets below $0180 in normal use. It is usually possible to put 
a very short machine-language program in locations $0100 through $017F. This 
is dangerous, since the program can plow the stack and vice versa, if either gets 
too long. 

Page Two is normally used as а keyboard buffer. Key entries start at $0200 
and build their way up. The average number of keystrokes stored is fairly low, 
and you can sometimes cram a small machine-language program on the top of 
this page. Once again, you are asking for trouble since too long a keyboard entry 
will plow your program. 

Опе sneaky and ugly trick that a programmer can pull is to put some reloca- 
tion or protection code starting at $0200. This code must be used before any 
keys are hit, and is thus very difficult to read The code will, of course, get 
destroyed as soon as any keys are entered. 

Most of page Three is available to the machine-language programmer. There 
are some DOS jumps and system vectors on the high end of this page. The 
vectors control the reset, interrupt, autostart return, breakpoints, Applesoft “8”, 
and nonmaskable interrupt jumps. 

Thus, you are free to use the first 150 or so locations on page Three for your 
machine-language program. This turns out to be a favorite stash for short pro- 
grams, since this area is automatically protected from either BASIC. 

Unfortunately, everybody and his brother crams just about everything they 
can think of in here, and you can often have two parts of a program, each of 
which needs a different machine-language code, both trying to use this space. 
For instance, a printer driver may be placed here by one program and a screen 
dump by another. Try to combine the programs, and you have a turf fight. 

If you have a longer machine-language sequence, you can sometimes com- 
bine the top half of page Two continuously with the bottom half of page Three. 
Again, you have to be careful not to get bumped by a long keyboard entry and 
to be sure you don't, in turn, bump into a DOS hook or other pointer. 

Memory pages Four through Seven are the page One text screen and page 
One LORES screen. The only difference between traditional text and LORES is 
that, in text, the stored code goes through a hardware character generator while, 
in LORES, the'same code is directly bit-by-bit converted into a pair of colored 
blocks. 

it seems kinda dumb to try and put machine-language code onto the display 
pages. First, you will probably see it and it will look ugly. Secondly, any scrolling 
or screen clearing will destroy the code. Nonetheless, in a program that does 
all its work in HIRES, this space is theoretically available. 











38 Enhancement 3 











There are some sneaky RAM locations stashed here and there on pages Four 
through Seven that are not displayed and are not erased by a properly done 
scroll or clear. There are 64 of these locations. These are normally intended for 
use by the I/O slots and have intended assignments. 

If you really want to be tricky, you can use these spaces апу way you want 
to, provided there is no 1/О access to the same location. This is one of the best 
hiding places for disk verification codes and other sneaky stuff. 

Summing our low RAM up, you have a few locations on Page Zero available 
to you that are usable to pass values to the monitor or to save calculated 
addresses. The low end of the page One stack and the high end of the page Two 
keyboard buffer can be used for short programs or subroutines, but use of these 
areas can be dangerous. Most of the bottom of page Three can be used for a 
machine-language program. This space is very popular but it can cause conflicts 
between programs. Finally, pages Four through Seven are the page One text and 
LORES display and are not normally available for Program storage, except for 
some 64 hidden locations that are normally reserved for input and output. 


High RAM 


As Fig. 3-3 shows us, the high RAM runs from $0800 up through the top of 
installed RAM. In а 48K machine, high RAM goes from $0800 through $BFFF. 
This area holds the usual locations where longer machine-language programs are 
placed. 

How much of high RAM is available for your use? It all depends on what other 
features you are going to run along with your program, and what minimum size 
Apple you want the program to run оп. 

We will assume that the target program needs a full 48K. Extra RAM is now 
so cheap that practically all Apples either arrive with full RAM or are soon filled. 
With those new 64K RAM cards, most Apples will soon have bunches of extra 
memory on top of what used to be “ІШІ.” A machine with a mere 48K of RAM 
will soon be at poverty level. 

Atany rate, if you decide to use text page Two or LORES page Two, locations 
$0800 through $OBFF have to be set aside and protected. Use of this text page 
is relatively rare. 

If you want to use HIRES page One for graphics, sprite animation, ог multifont 
text displays, then locations $2000 through $3FFF have to be reserved. Use 
HIRES page Two and you will also have to reserve locations $4000 through 
$5FFF. These locations hold an image of what goes on the screen and, thus, are 
Not available for both display and program use at the same time. You will 
sometimes use both pages at once for effective and fast animation or to double 
graphics resolution. 

While there are а few unused RAM locations on these HIRES pages, these 
locations get plowed every screen reset or color change. Thus, they are not 
safely usable except as a very temporary stash. 

We will note in passing that if the HIRES pages are not used, and you put code 
in this area, you can actually watch the code executing by switching to HIRES 
while the program is in action. This can be a very powerful snooping tool 
Watching a program run its own code gives you a new window into what is 
happening. You can also watch code working on LORES page Two, but this is 
a much smaller area and not nearly as useful, 

If you are using standard DOS, the space from $9600 through $BFFF is 
normally saved for the DOS system. You can sometimes “borrow” a DOS file 
or two and stuff a short machine-language sequence into a small Portion of this 
protected space. 
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SBFFF 
(49151) 


THE DOS 33 OPERATING SYSTEM 
SITS AT THE TOP OF HIGH RAM. 
SMALL WORKING PROGRAMS CAN 
BE STORED HERE IN UNUSED DOS 
FILE AREAS. THIS SPACE MAY 

BE FREED UP BY GOING TO A 
SMALLER CUSTOM DOS OR BY 
MOVING DOS ONTO А RAM CARD. 


TT AVALABLE PROGRAM SPACE 


MIRES PAGE TWO IS USED FOR. 

ANIMATION AND GAMES WHERE 

ONE PAGE IS DISPLAYED WHILE 
tines |=” тне OTHER is MODIFIED. MUST BE 
(PAGE TWO) PROTECTED WHEN USED. 


HIRES PAGE ONE RESIDES HERE 
AND IS USED FOR BOTH COLOR 
HIRES |. -- GRAPHICS AND MULTIFONT TEXT 
(PAGE ONE) DISPLAYS. MUST BE PROTECTED 
WHEN USED, 


" Р) 
|. AVAILABLE PROGRAM SPACE. 


m LORES AND TEXT PAGE TWO. 
essa VERY RARELY USED. 


Fig.3-3. High RAM memory map. 


A lot of programs provide their own smaller and simplified versions of DOS. 
This gives a measure of copy protection and makes more room for the rest of 
the program. 

Thus, a machine-language program could go from 50800 to SBFFF. Subtract 
the range $9600 through $BFFF for DOS at the top, the range $4000-$5FFF for 
HIRES page Two, the range $2000-$3FFF for HIRES page One, and, if used, the 
range $0800 through $0BFF at the bottom for text and LORES page Two. 

Many machine-language programs start at $0800 and work their way up- 
wards as needed. If they are about to crash into the HIRES pages, they jump. 
above HIRES and continue as far as they have to. 


Combining programs 


Things get much more complicated if machine-language subroutines have to 
interact with Integer or Applesoft BASIC programs. Each BASIC language works 
differently and needs a different way to “protect” an area for its machine- 
language routines. The protection is needed to keep the BASIC from overwriting 
the machine code and vice versa. Fig. 3-4 shows us more detail. 

In Integer BASIC, HIMEM is a high-memory pointer that points to the end of 
the Integer program. The program starts at HIMEM and builds its way down- 
ward. Every new program line gets put in its place, automatically moving every- 
thing else down and leaving you with the end of the program listing at HIMEM. 
String variables start at the low-memory pointer LOMEM and build their way 
upwards. 

The usual way to tie a machine-language program into Integer BASIC is to start 
the machine-language sequence at $0800 and set LOMEM to at least one space 
above the end of the machine-language code. This LOMEM can be set as the 
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first instruction of an Integer BASIC program. It takes an “Шева!” command, but 
it is easily done with a single POKE command. Should you also be using the 
HIRES pages, you still would start your machine-language program at $0800, but 


NORMAL. 
seo НІМЕМ 
INTEGER 
BASIC 

PROGRAM 

LOMEM SET 
? ТО ТОР ОҒ 

MACHINE 
CODE +1 


50800 





MACHINE 
CODE 






HIMEM БЕТ 
қ, |- TO BOTTOM 
OF MACHINE 
CODE -1 
APPLESOFT 
STRINGS AND 
VARIABLES 
? -үт--иомым 
APPLESOFT 
PROGRAM 
LINES 
STARTOF 
PROGRAM 
50800 -4— POINTER 
SET TO 2048 
(TXTAB) 


(С Anplesoft BASIC, no HIRES. 


<j NORMAL 
HIMEM 


LOMEM SET 
ТО 16385 





$9600 







HIMEM SET 

„— TO BOTTOM 
OF MACHINE 

CODE -1 


APPLESOFT 
STRINGS AND 
VARIABLES 


LOMEM SET 
ТО 16385 


oe 


APPLESOFT 


STARTOF 


(D) Applesoft BASIC using HIRES 1. 


Fig. 3-4. Usual ways of combining BASIC and machine-language programs. Note that 
machine code goes 2bove Applesoft or below Integer. 
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you would most likely reset your LOMEM pointer to one location above the 
highest HIRES screen location needed. This is shown in Fig. 3-48. 

Applesoft does things quite differently than Integer Basic. Applesoft programs 
start at a start-of-program pointer TXTAB and build their way up, while the string 
variables start at HIMEM and work down. 

It is not normally possible to change the start-of-program pointer during a 
program since the program is already located in memory and is not movable. 
Thus, while you can, in theory, put а machine-language program below this 
pointer, the only way to do it is to change the start-of-program pointer before 
you load your final Applesoft program. 

Note that this start-of-program pointer is not LOMEM! It is called TXTAB and 
sits at $0067 (low) and $0068 (high). LOMEM in Applesoft is actually in the 
middle. LOMEM points to the beginning of the variable space and often marks 
the end of the program lines. 

You will usually put your machine-language program above Applesoft by 
setting HIMEM before you run your Applesoft program. HIMEM may also be 
set early in the program. Details on this are shown in Fig. 3-4C. 

For more program room, you also have the option of setting HIMEM to one 
less than the start of your machine-language program, and LOMEM to one more 
than the highest HIRES location in use. The start-of-program pointer remains at 
$0800. This lets you put program lines from $0800 up through the start of the 
HIRES page, and place the strings and variables from the top of the HIRES space 
to the bottom of your machine-language code. This is shown in Fig. 3-4D. 

So, we see that machine-language programs running with Applesoft normally 
go above HIMEM, while machine-language programs running with Integer 
BASIC normally go below LOMEM. 

You can also play all sorts of pointer games to tow a short machine-language 
sequence along inside an Integer BASIC or Applesoft program. One way you can 
do this is to put the machine-language stuff betweentwo BASIC statements. The 
parsed code on the first BASIC statement is then altered so it jumps over the 
machine-language part to get to the next expected instruction. These pointer 
schemes are tricky and really get hairy if you make any changes, but some 
authors use them to “protect” their programs or “hide” their fast machine code. 
The advantage of this is that you can use one cassette loading to enter both 
machine and BASIC codings. With a disk it is much simpler and saner to let one 
program load the other one by using а second disk command. 

Mainframe RAM usually only goes up to 48K. What is in the other 16K of our 
64K Apple? Figs. 3-5 and 3-6 complete the picture for us. 

There are sixteen pages located from $С000 through $CFFF that are reserved 
for 1/O. As Fig. 3-5 shows, the bottom half page (5С000 to $CO7F) is used for 
all the screen switches, the push buttons, the paddles, speaker, cassette, key- 
board entry, and the keyboard strobe. The next half page ($CO80-COFF) is used 
to pass address locations to each slot. There are sixteen locations reserved for 
each slot one through seven. 

‘Above that, we see seven location blocks that are one page of 256 words 
each. These usually will hold the “control” PROM ог ROM for a given card and 
are addressed as shown. A final 2K space is reserved from $C800 through $CFFF 
that can be used by any 1/О slot that wants it, as long as all the slots take turns, 
and only one slot is active at a time. 

There is usually very little RAM in the 1/О space. These locations are impor- 
tant, though, for they are how we control the on-board things like the screen 
modes, speaker, paddles, keyboard, and so on. They are also the way we 
interact with any working card. If a plug-in card is involved with the code you 
want to tear into, you will have to pin down exactly what codes goes where. 
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If we now turn to the uppermost 12K of address space on the Apple, we see 
that there are six ROM sockets on the Apple mainframe. Each socket can hold 
a 2K х8 bytewide ROM or RAM. Fig. 3-6 shows us the usual setup for Integer 
BASIC or Applesoft machines. A 2K monitor ROM needs the top or $F8 socket. 
There are two possible monitors, the old or absolute reset one, and the newer 
autostart one. 
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Continuing down our ROM sockets, Applesoft uses the bottom five, while 
Integer BASIC uses the middle three, along with an optional programmer's aide 
that fits in the bottammost or “DO” socket. The uppermost Integer ROM at “ҒО” 
also holds the extremely useful single step and mini-assembler code, along with 
the old floating-point package. None of these machine-language test and debug 
features are available in the Autostart ROM. 

This area is all ROM and cannot normally be written to. But the locations in 
this area are useful to interact with the monitor or either BASIC language. 

The entire top of the machine can be bypassed by any plug-in card through 
the INH line. This can let a plug-in КОМ card give you the switched choice of 
either BASIC, or it can let a RAM card do darn near anything it wants 52 
including running other languages or giving you extra RAM space. 
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SFFFF SFFFF ван 
яв зе E 
ша. 
BASIC 
$E000 INTERPRETER 
50800 
50000 50000 (- 12288) 


(A) Integer BASIC. (8) Аррезой. 


Fig. 3-6. High ROM maps. A plug-in ROM or RAM card can deactivate these and 
substitute its own code, 


Note that many software programs placed on RAM cards may deny you ever 
gaining access to the monitor ROM in mainframe socket $F8. This can make 
intercepting a running program rather tricky. 

Many machine-language programs will start at $0800 and work their way 
upwards, but you can expect any program to go just about anywhere, depending 
on what other resources of the Apple are being tapped. 

One ultrasneaky trick is to start your machine code at the bottom of the 
keyboard buffer at $0200, with a jump, and then run up through everything in 
between there and the end of your machine-language program. This neatly hides 
the “real” starting address of your program and also gives you an attractive page 
One text or LORES display while the rest of the program is loading. 

You must, of course, find out where the program is before you can attack it. 
Let's start with a very obvious fact . . . . 


You cannot tear a program apart 
that is not already in the machine 
OBVIOUSLY and capable of running 


What this says is that any program that uses a disk may not have that part of 
the program in which you are interested sitting in the machine at any given time. 
This rule also says that any program must be placed in the machine exactly 
where it normally will run, and it must be started off on exactly the first instruc- 
tion location. 

So, be sure you have that part of the program that you want to analyze in the 
machine when you attack it. 

The other side of the coin has the good news . . . 





At any given time, any working 
BUT, program MUST have everything it 
THEN needs in the machine so it can 


continue. 





AGAIN 


So, if there is no disk whirring between where you are and what you want 
to analyze, it all has to be there in the Apple somewhere, somehow. 
But, where is where? 2 
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You must pin down all of the exact locations a target program uses before you 
can tear into it. There are at least four good ways to do this. . :. 


FINDING PROGRAM 
LOCATIONS 





( ) Read the instructions. 


() Ask DOS to tell you. 
(3 Infer from use. 
() Empty, then fill the machine. 





The first and most obvious way is to see if the author didn't tell you some- 
where just exactly where the program sits. For instance, the loading instructions 
for the Adam's Adventures 0-12 tell you these go from $0800 through $57FF 
and that the starting point is $0800. Being told ahead of time where the program 
starts and resides is the easiest and best method, so always look around carefully 
for loading information. 

The second way to find where a machine-language program goes is to let DOS 
tell you. On a 48K machine BLOADed under DOS 3.3, the starting address ends 
up stashed in $AA72 (low) and %АА73 (high). The program length is stashed in 
SAA60 (low) and $AA61 (high). After loading, you reset, do а call —151 to get 

то the monitor, and, then, inspect these locations. The old monitor ROM might 
зе needed to force reset back into the monitor. 

DOS can also give you some hints. If you can read the catalog, the type of 
file and its length should be obvious. Even listening to the number of track clicks 
during a load should tell you something about how long the program is and 
Which disk tracks it lies on. Take off the disk drive cover, and you can actually 
watch the drive move from track to track. With some practice, you will be 
surprised how much this can tell you. 

Thethird method of finding a machine-language target program's lair is to infer 
where the program sits from what it has to do and what it has to interact with, 
Our HRCG gives us a good example here. We can't directly find where HRCG 
sits since it is ап “R”, or relocatable, rather than а “В”, or binary file. 

But, the Applesoft Toolkit book tells us HRCG fits under DOS and moves 
HIMEM down to protect itself and its alternate character fonts from Applesoft 
incursion. There's a simple and easy-to-use BASIC program called LOADHRCG 
that comes with the HRCG program. In it is a variable called ADRS which equals 
HIMEM. Run this one with no alternate character sets, and we see that ADRS 
ends up as $8DFE. Run it with one alternate character set, and HIMEM moves 
three pages lower to $8AFE. Two alternate sets and HIMEM diops three more 
pages lower to $87FE, and so on. This special example is shown in Fig. 3-7. 

So, by inference, HRCG sits from $8DFF through $95FF. This will include the 
НЕСС action and the bulk file used for character set Zero, the default ASCII set. 
Other character sets build downward three pages at a time, with the lowest- 
numbered set on the bottom and the highest set always at the top, again as 

| shown in Fig. 3-7. 

! You сап find this out on your own by carefully studying а printout of the 
JADHRCG Applesoft program and then doing loadings and finding the value 

of ADDR, otherwise known аз HIMEM. The same study should show you how 

the alternate character sets are filled in. 








Tearing Into Machine-Language Code 45 




















The final method of pinning down a large program works even if all other 
methods fail, and should be used as a check even if you are absolutely sure 
where the target program sits. This final method is a sledgehammer. You empty 
the machine completely, and then refill it only with your target program. Then, 
you casually flip through memory, a page at a time, till you find the program. 
The next tearing step gives us full details on this. 





CHARACTER SETS BUILD DOWN 
FROM HRCG. THE HIGHEST SET 
ALWAYS GOES JUST BELOW НЯСО. 
HIMEM MOVES DOWN АЗ FAR AS 
NEEDED TO MAKE ROOM FOR 







aan MORE SETS. 
Е ди = Е Ч 
387ЕР 
SB4FF | тетт | APPLESOFT HIMEM 


|--—— POINTER 384ЕЕ. 
(РОН З ALT SETS) 


Fig. 3-7. Location of HRCG program and alternate character sets in a 48K Apple II. 


We have now seen how an Apple's memory is arranged and the methods we 
need to use to find where a program sits. Let's now return to the mainstream 
of our tearing attack. 

You can use any method vou like to pinpoint exactly where the target program 
lies. Try reading instructions, and then try letting DOS tell you. Then, try infer- 
ence from what the program does and how it interacts with the Apple. If none 
of that works . 


EMPTY THE MACHINE | 


There is nothing more infuriating than to find out you are really analyzing 
interpreted BASIC code left over from last Tuesday’s 4 AM breakout game, 
instead of your target program. 

To prevent this from happening, you will want to completely and absolutely 
empty your machine of everything old and unneeded before you begin. There 
are two very good reasons for this. One is that you won't be wasting your time 
analyzing something that is not part of your target program. The second is that 
an empty machine that has just been filled is one sure way to find or verify the 
location of your target program. 

You should always clear your Apple of old stuff before attacking a target 
program. But, how do you empty a machine? 

Even a just repowered Apple will come up with random garbage in most all 
of the RAM locations. The trick is to load each and every memory location with 
an obvious value that is very easy to spot, particularly when it is scrolling by. 
The value $00 is dangerous since it is also a Break command, and it is hard to 
read on the fly. | use the value 511 instead. On a listing, you get an unmistakable 
string of continuous lines on anything that is still empty. This pattern is readable 
even during an abrupt scroll. 

The following steps show us how to empty your Apple. It's very easy to do 
from the monitor. You put a $11 somewhere and, then, move it as far up in 
memory as you want, recopying it over and over again. If you are using DOS 
3.3, you should empty locations $0220 through $03CE, and $0800 through 
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.95FE. Be sure to empty your machine after booting DOS. Do things the other 
way around and the DOS-booted code will return to haunt you.* 

If you are not using DOS, then you can go ahead and empty $9600 through 
SBFFF as well. You might also like to empty page One from $0100 to $0180. 
But, don't try to empty page Zero, the top half of page One, the first few 
locations of page Two, the top of page Three, or anything above $С000. Erasing 
any of these locations will bomb the machine or cause other problems. 

To empty your Apple, put an "empty" symbol in some location. Then, use 
the monitor to move a block of memory—starting at that location and moving 
up by one. 

A good empty symbol is “8117. 

A. To empty user RAM except for DOS: 


70800: 11 «cr» 
“0801 <0800.95FEM «cr» 


B. To empty all user RAM: 


70800: 11 «cr» 
0801 < 0800.BFFEM «cr» 


С. To empty most of pages $02 and $03: 


30220: 11 «сг» 
"0221 <0220.03CEM «cr» 


To get into the monitor from either BASIC language, do а CALL —151. Do 
not try to empty page Zero, the top half of page One, the first few locations on 
page Two, page Three above SO3CF, or anything above $С000. 

Some target programs will try to prevent you from ever going into the monitor. 
Switch to the old (nonautostart) monitor ROM if this happens. 

When your machine is empty, snoop around everywhere to see what it looks 
like. From the monitor, do а 0800.BFFF «cr» and watch the “elevens” go 
streaming by. 

You'll next want to load and verify the locations of the HRCG program from 
S8DFF through $95FF. Try adding alternate character sets, one at a time, and 
see what happens. 

Always start with an empty machine and always return to one anytime you 
get confused as to what is happening. 


LIST THE PROGRAM J 








After you have emptied the machine and loaded your target program, go 
ahead and list it. Make two copies on the heaviest white tractor paper you can 
find. You list a program from the monitor by typing the starting address and, 

en, the character “L” eighty times and, then, а «cr» . Each L command gets 
you twenty lines of disassembled code. Use too few 1/5 and you will have to 
retype them in the middle of your listing. Too many and you simply hit RESET 
when you get to the end of the target program. 
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Keep three clean white pages before and after the listing. Do NOT take the 
listing sheets apart. Instead, carefully reinforce every tear line, tractor hols: ond 
all, with transparent tape. Actually, you would be best off having a welder 
transcribe a copy of the listing by burning it into quarter-inch steel plate for you. 

No matter how rugged you make it, it won't be enough. The object here is 
to keep the listing in one piece and legible after handling and rehandling over 
and over again. So, don’t spare the tape. 

Label the top sheet with the name of the target program and the date you 
started attacking it. Don't forget the year. The second copy is a backup to be 
used when the first one falls apart or gets totally illegible. 

You will also want to make two copies of a hex dump of the target program. 
For HRCG, you get in the monitor, type 8DFF.95FF, reach over and move the 
printer paper up a space or two, and, then, hit <cr>. Incidentally, on both the 
listings and the hex dump, use the printer's skip-over-margin feature if you have 
it available, 

Most of our tearing apart will be done on the listing sheets. The hex dump 
sheets will sometimes show us a pattern in a file or will give us some other 
pictorial information or other visual clues that can be of enormous help. 

Yes, you might have to list and hex dump the entire machine for really fancy 
programs, and this will take bunches of paper and, maybe, a ribbon or two. But 
this isn't nearly as bad as it seems, and it must be done if you are to crack the 
program. 

Well, we finally have completed our preliminaries. It sure took a long time to 
get here. Now the fun starts. Ready? 


SEPARATE THE ACTION FROM BULK FILES | 


Carefully look at your listing. Not for detail, but for overall vibes. Anytime you 
think something may be helpful, jot it down on one or another of the pads. 

But, once again, do not jump to conclusions and do not attempt to analyze 
any part of the code in detail. At this stage in the game, we are interested only 
in the flow and pattern of the big picture. 

The first thing we want to do is isolate the action so that we can work with 
it separately. As you go along, you will gain a feel for what! call “rational” code, 
Rational code has a flow to it, with reasonable commands used in reasonable 
ways. At this point, we don’t want to pass judgement nor force conclusions as 
to what is which. But see if you can't separate obviously "rational" code from 
everything else. 

Now, we told our lister to list—assuming that it would be handling working 
machine-language code. The lister will also try to list a file, or random garbage, 
as if it was rational code. So, we can expect lots of visual clues as to whether 
we are working on real code or file values. Here are some sure signs of a file. 





FILE CLUES DURING A LIST. - 





( ) Lots of question marks. 
( ) Break commands (500). 
( ) Dumb repetition. 


( ) Rare commands in odd mixes. 
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The question mark means that the lister thought it had found an illegal op 
code, something that the 6502 microprocessor does not know how to use as 
an instruction. Now, there are times and places where you will get an occasional 
question mark in the middle of working and valid code. This has to do with the 
lister” getting out of whack on the first instruction, or it may (rarely) be a value 
or two a programmer has put between working code segments. But, lots of 
question marks are a good sign of a file. 

The break or $00 command is a very enigmatic one. BRK is a very heavy 
debugging tool and one of the most powerful commands that the 6502 micro- 
processor has available. But, a break command is only rarely allowed to appear 
in working code as a valid instruction! Why? Because the break command 
immediately forces a debugging interrupt, or else, it might very rarely be used 
for an error trap or a program restart. 

Dumb repetition is another clue. Say you push the processor status on the 
stack with a PHP command. That's fine. But, why on earth do it fifteen times 
in a row? Now, that is irrational. As you go along, you will get a feel for what 
is rational code and what is not. 

Do it. Start through your HRCG listing. There's a few question marks at the 
beginning and a few breaks, but mostly it is rational code. Chances are these are 
stashes that go with the code modules. As you go along, you get lots of rational 
code. Continue some more. Page after page of rational code. 

Then, suddenly, around $92DF, things get weird and stay that way, all the way 
to the end of the program. Lots of question marks, breaks, and really dumb code. 
Let's take a guess and say that our bulk file goes from $92FF to $95FF. 

Now, it looks like there's some garbage, maybe a stash below $92FF, but we 
jefinitely have at least three pages of bulk file at the top. 

Let's speculate. Three pages should ring a bell. Check into the HRCG book 
and you'll find it takes three pages for an alternate character set. Apparently, we 
have the default ASCII character set here. We absolutely should NOT jump to 
conclusions this early in the game, nor should we try a detailed analysis of the 
bulk files, but maybe just a little peek won't hurt . . . . 

Check the hex dump for these pages. See the pattern? Hold it up to the light. 
Every eighth row almost, but not always, is all zeros. Except for the lower case 
в, р, and a few other exceptions, most characters would leave one dot row out 
of eight blank. 

Strong evidence. 

But, not strong enough. Later, we will tear into this bulk file and verify exactly 
what it does. We will also find out exactly where it starts. For now, let's draw 
a bright red line across the listing page between $92FD and $92FF. Label the 
area below this line “BULK FILE." On your serendipity pad, sketch something 
like Fig. 3-8, that is used to show us with an HRCG action from $8DFF through 
$92FE and a bulk file from $92FF through $95FF. 


ВЕР 
HOLDS DOT PATTERNS 
| «cn DEFAULT 
CHARACTER SET 


HOLOS CODE MODULES 
|— AND STASHES USED 


Еа 


Fig. 3-8. Separating the action from the bulk files. 


Don't worry, just yet, about the extra question marks we have above the bulk 
file. Somehow, these look "'different'" from the code in the bulk file. As you gain 
practice, these slight differences will leap out at you. But, our goal, here and 
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now, is only to separate the action from the bulk files, nothing more. in кк, 
this roughly cuts our task in half. In other programs, the bulk files may be the 
lion's share of the code. 


PAINT ALL SUBROUTINE RETURNS GREEN | 


No matter what code you write or how secretive you are, there is an Achille's ! 
heel you have to contend with. This is the 60 RTS ог Return From Subroutine 
command. RTS is our first and foremost attack point into unknown code. It is 
the chink in the armor, the pry point, the skeleton key. Let's split off the subrou- 
tines and watch how fast the code breaks up. 

Go through your code and at every “гайопа!” place that you find a 60 RTS, 
put a green bar through the code. Something like this . . . 








GREEN STRIPE A 





Do this for every 60 RTS you see in the action. If you aren't sure whether the 
60 is rational or not, then color only the RTS green, rather than the entire line. 
Generally, question marks be/ow a 60 RTS are allowed; those close above are 
suspect. 

If you do this on HRCG, you should end up with 35 “definites” that are 
greenlined all the way across, and one "maybe" located at $8F85 that is only 
boxed. 

Do not try to analyze any of this code yet. We will let the code analyze itself 
later on. 

We have just identified the end of every subroutine in the program. Since 
properly written machine-language programs will be mostly subroutines, we 
already have nearly all our code modules isolated! АП that with several strokes 
of a fuzzy green page underliner! 

Now, things start to get interesting . . . . 


PAINT ALL SUBROUTINE CALLS ORANGE | 





Next, get yourself an orange page ипдегіпег and go through the action. 
Identify every rational JSR and its address in orange. 

Do this two ways. If the JSR goes to a /оса/ address inside the action, paint 
only the JSR and the address. If the JSR goes out-of-range to some other part of 
the memory, paint the JSR, the address, and one inch more, and “half” an 
arrowhead. 
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Like so for а local JSR 





Ї 
! 
о 
! 
О! ЗВЕОЕ- 20 1F ВЕ 


| ын ORANGE 








This subroutine call is in range, so we color only the JSR and the $8E1F. 
For an out-of-range or "long distance" call, do it like this . . 








І 
І 
І ORANGE 
! 
1 


$ВЕ16- 20 ED FD 








You use the arrowhead to identify ап out-of-range call. Should you have а 
questionable or possibly irrational subroutine call, color only the JSR mnemonic 
for now. (The reason for only half an arrow is that you might get two arrows 
side-by-side. If this happens, make one point “ир” and the other "down.") 

Orange is a nice color, so let’s use it some more. For each and every local 
JSR call, find out where the JSR goes to, and color the very start of that line 
orange. Go only through the address, starting a quarter of an inch to the left. 

For instance, at $ВЕОЕ, you have a local call of JSR $8E1F. Go to the start of 
line BETF and do this . . . 





LDA #$74 


This tells us that we are starting on some "'live" and rational code, and that 
what follows will be a useful and worthwhile subroutine. Once again, we do not 
want to analyze any code just yet. 
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Two fine points. If there is a/ready an orange stripe here, ог опе of another 
color, just put a small black dot on the existing stripe. Each new time this 
happens, add a new black dot. 

This will give you a “popularity poll" of your subroutines. We probably won't 
use this voting result for our HRCG analysis, but in a large program, the populari- 
ty of a subroutine can tell you how important that sub is and how much effort 
you should spend in understanding it. 

Asecond possibility is that your JSR seems to go to the middle of an op code, 
instead of just the start. The most likely reason for this is that the lister got off 
оп the wrong foot. See the “WILL THE REAL LISTING PLEASE jUMP OUT” 
sidebar located at the end of this enhancement for details on this. What happens 
is that the lister starts off with a value or two іп a file and assumes it is a valid 
part of a program that can be disassembled. Op codes normally take one, two, 
or three bytes. If the first byte is wrong, the listing will also be wrong. 

If you get a “ISR to the middle of . . .”, try relisting from the /5К address to 
see if you get rational code. This will help clarify the boundaries between stashes 
and code modules. We will see an example of this later. 

Should your JSR want to go to your bulk file, you guessed wrong! Either the 
bulk file has a code module in it, or else your JSR really is a random “20” in 
a stash somewhere. Pay careful attention to loose ends like this, for pinning 
down exact code and file beginning addresses can save you hours of frustration. 

After all of your local subroutines are taken care of, try to identify the out-of- 
range ones. They must go somewhere. Somewhere is most often a monitor 
subroutine, or some subroutine-supporting DOS or either BASIC language. 

Table 3-1 shows us the most popular locations needed by the monitor, DOS, 
and !/О. Try to get a match between Table 3-1 and each out-of-range subroutine 
call. Label this match with a brown felt-tip pen. We have purposely kept this list 
down to the more popular locations. We may look at Applesoft, Integer BASIC, 
and DOS internals in a future enhancement. Most user libraries have very 
extensive memory listings if you get into something out of the ordinary. 

For instance, in $8E16, we have a JSR $FDED. A check of Table 3-1 shows 
us that it is one of the most often used monitor routines called COUT. This 
routine takes what is in the accumulator and outputs it as a character. This output 
goes to whatever is connected to the character output hooks. The code should 
now look like this ... 





V 
о! е) 


1 
| 1 
О! 58Е16- 20 ED FD .- COUT (output character) 10 
! 
! 1 
o! 5 BROWN FELT TIP = He) 
! 





Notice that this immediately tells us that the code module is used to output 
characters. This very much pins down how the module is used and its place іп 
the big picture. And we still haven't analyzed any code. 

Sometimes a JSR call will point to a different part of user RAM. This usually 
means that the target program is in more than one piece. Each piece, of course, 
will eventually have to be dealt with. The Wizard and the Princess is a good 
example of a program that has code modules all over the lot. 
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Table3-1. Important Monitor, DOS, and 1/О Locations 
PAGE $00 2 
Hex Decimal Mnemonic Use 
$20 32 WNDLFT — Lefisideof scroll window 
$21 33 WNOWTH Width cf scroll window. 
$22 за WNDTOP ^ Topofscrollwindow 
$23 35 WNDBTM ^ Botomofscroll window 
$24 36 CH Cursor horizontal position 
$25 37 су Cursor vertical position 
$26 38 GBASL LORES graphics base low 
527 39 GBASH LORES graphics base high 
$28 40 BASL TEXT baseaddress low 
529 а ВАЅН TEXT base address high 
52А 42 BAS2L Scroll temporary base low 
$28 43 ВАЅ2Н Scroll temporary base high 
$30 48 COLOR  Holdsthe LORES color value 
$32 50 INVFLG  Normal/inverse/Flash mask 
$33 51 PROMPT —_Holds prompt symbol 
534 52 YSAV Temporary Y register hold 
$36 54 CSWL ‘Output character hook low 
$37 55 CSWH Output character hook high 
$38 56 KSwL Input character hook low 
$39 57 KSWH Input character hook high 
545 69 ACC Accumulator save 
$46 70 XREG X register save 
$47 л ҮКЕС Y register save 
$48 2 STATUS —— Flagregistersave 
$49 2 SPNT Stack pointer save 
$4Е 78 RNDL Keybounce random number low 
$4F 79 RNOH Keybounce random number high 
PAGE $03 
Hex Decimal Mnemonic Use 
$0300 976 Re-enter DOS 
$03EA 1002 Reconnect DOS ИО hooks 
$03F0 1008 BRKV Break vector low address 
$03F1 1009 Break vector high address 
$03F2 1010 SOFTEV Warm start vector low address 
30363 1011 Warm start vectorhigh address 
$03F4 1012 PWRDUP Warm start EOR AS checksum 
$03Е5 10132: АМРЕВУ Applesofi “&" low address 
303F6 1014 Applesoft *& high address 
$03F8 1016 USRADR Control ¥ vector low address 
$039 1017 Control Y vector high address 
Зозев 1019 NMI NMI vectorlow address 
$03FC 1020 NMI vectorhigh address. 
$03FE 1022 IRQLOC Interrupt vector low address 
| $03FF 1023 Interrupt vector high address 
—— 
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Table 3-1 Cont. 


Important Monitor, DOS, and ИО Locations 











PAGE 5С0 

Hex Decimal Mnemonic Use 
5000 — 16384 IOADR Keyboard input location 
5с010 — 16368 KBDSTRB Keyboard strobe reset 
5С020 = 16352 TAPEOUT Cassette data output 
5С030 -16336 SPKR Speaker click output 
$C040 -16320 STROBE Came i/Oconnectorstrobe 
5с050 - 16304 TXTCLR Graphics ON soit switch 
5051 -16303 TXTSET Text ON soft switch 
$6052 = 16302 MIXCLR Fullscreen ON softswitch 
5С053 — 16301 MIXSET Split screen ON soft switch 
5С054 -16300 LOWSCR Page ONE display soit switch 
$6055 -16299 HISCR Page TWO display softswitch 
5С056 — 16298 LORES LORES ON soft switch 
$C057 -16297 HIRES HIRES ON softswitch 
$6058 — 16296 ‘Annunciator OOFF softswitch 
$0059 -16295 Annunciator 0 ON soft switch 
5С05А —16294 Annunciator 1 OFF softswitch 
5С058 -16293 Annunciator 1 ON soft switch 
3С05С -16292 Annunciator 2 OFF softswitch 
$COSD -16291 Annunciator 2 ON soft switch 
5С05Е — 16290 Annunciator 3 OFF softswitch 
5С05Ғ —16289 Annunciator3 ON soft switch 
5С060 -16288 TAPEIN Cassette tape read input 
50061 -16287 PBO Push button 0 input 
$co62 -16286 * PBI Push button 1 input 
5С063. -16285 РВ? Push button 2 input 
5С064 -16284 PDLO Game Paddle 0 analog input 
5С065 -16283 PDLI Game Paddle 1 analog input 
$5066 — 16282 PDL2 Game Paddle 2 analog input 
5С067 -16281 PDL3 Game Paddle 3 analog input 

-16272 РТС Reset analog paddle inputs 
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Table 3-1 Cont. Important Monitor, DOS, and О Locations 






































MORE PAGE СО - 
Hex Decimal Mnemonic Use 
5С080 — 16256 Disk stepper phase 0 OFF 
5С081 —16255 Disk stepper phase Ом 
$C082 —16254 Disk stepper phase 1 OFF 
$6083 — 16253 Disk stepperphase 1 ОМ 
$0084 = 16252 Disk stepper phase 2 OFF 
5С085 -16251 Disk stepper phase 2 ОМ 
5С086 -16250 Disk stepper phase 3 OFF 
$6087 — 16249 Disk stepper phase 3 ОМ 
5с088 - 16248 Disk main motor ON 
5С089 -16247 Disk main motor OFF 
5С08С — 16244 Disk Q6CLEAR 
5С080 -16243 DiskQ6 SET. 
$COBE -16242 Disk Q7 CLEAR 
$coar 16241 Disk Q7 SET 
Q7 06 ACTION 
clear clear READ 
clear set — SENSE 
set clear WRITE 
№ set set LOAD 
PAGES $ЕВ — $FB 
Hex Decimal Mnemonic Use 
5Ғ800 -2048 PLOT Plota block on LORES screen. 
$F819 -20233 HLINE Draw а horizontal LORES line 
$7828 -2008 VUNE Draw a vertical LORES line 
$7832 — 1998 CLRSCR Clear full LORES screen. 
$7836 — 1994 CLRTOP Clear top of LORES screen 
$847 — 1977 СВАЅСАІС Calculate LORES base address 
5Ғ85Ғ -1953 NEXTCOL Increase LORES color by three 
$7864 — 1948 SETCOL Setcolorfor LORES plotting, 
$F871 -1935 SCRN Read colorof LORES screen. 
5Р941 -1727 РЕМТАХ Output A then X as hex 
5Ғ948. -1720 PRBLNK Output three spaces via hooks 
SFS4A -1718 PRBL2 Output spaces via hooks 
SFA43 -1469 STEP Singlestep (old ROM only) 
$FAD7 -1321 REGDSP isplay working registers. 
SFBIE -1250 PREAD Read a game paddle 
SFB2F — 1233 INIT Initialize tex screen 
$r839 -1223 ЅЕТТХ] Set uptextscreen 
5Ғ840 -1216 SETGR Set upLORES screen 
5ҒВ4В -1205 SETWND. Set text window to normal 
$ЕВС1 -1087 BASCALC Calculate text base address. 
$FBD9 -1063 BELLI Beep speaker if ctr! G 
SFBES -1052 BELLZ Beep speaker once 
$FBFA -1036 ADVANCE Movetext cursor right by one 
SFBFD -1027 VIDOUT Output ASCII to screen only 
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| 
| Table 3-1 Cont. Important Monitor, DOS, and ИО Locations 
| PAGES ЕС — $FD 
Е Hex Decimal Mnemonic Use | 
$FC10 — 1008 BS Backspace screen 
$FCIA -998 UP Movescreen cursor up one 
$FC22 -990 VTAB Vertical screen tab using CV 
| $FC24 —988 VTABZ Vertical screen tab using A 
| ос -980 ксі Process escape movements A-G 
! 4#С42 -958 CLREOP Clear text to end of screen 
! $FC58 -936 НОМЕ Clear screen and home cursor 
$FC62 -926 ск Carriagereturn to screen 
i 5ҒС66 -922 G Line feed to screen only 
i 5ЕС70 -912 SCROLL Scroll text screen up one 
1 SFCIC — B68 СОГ Clear text to end of page 
1 $FCAB -856 WAIT Time delay set by accumulator 
1 
$2005 -756 RDKEY Get input character via hooks 
$FDIB -741 KEVIN Read the Apple keyboard. 
1 $FD35 -715 RDCHAR Get key and process ESC A-F 
$FD62 -670 CANCEL Cancel keyooard line entry 
| $FD67 — 665 GETLNZ CR, then get kbd input line. 
| $FD6A — 662 GETLN Get input line from keyboard 
| $2062 -657 GETLNI Get kbd input, no prompt 
CROUTI Clear EOL then CR via hooks 
CROUT Outputreturn via hooks 
РЕВҮТЕ Outputfull А in hex tohooks 
PRHEX ‘Output low A in hex to hooks 
сол Outputcharacter via hooks 
Cour Outputcharacter to screen 
PAGES $FE  SFF 5 
Mnemonic Use 
MOVE Move block of memory 
VERIFY Verify block of memory 
LIST Disassemble 20 instructions. 
1572 Disassemble A instructions 
ЗЕТІМУ Print inverse text on screen 
SETNORM Print normal text on screen 
SETVID Grab outputhooks for screen 
XBASIC Goto BASIC, destroyingold 
BASCON GotoBASIC, continuingold 
TRACE Start tracing (old ROMonly!) 
WRITE Save to cassettetape 
READ Read тот cassette tape 
PRERR Print "ERR" to output hook 
BELL Output bell via hooks 
IORESR Restore all working registers 
IOSAVE Save all working registers 
OLDRST Oldreset entry, по autostart 
MON Enter monitor and beep spkr 
MONZ «Enter monitor quietly 
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As you tear into your target program, go through each and every subroutine 
<ай and find out what it points to. If there are a few locations that are unexplain- 
able, wait till later on these. Just be sure that you pin down as many subs as you 
can. 

Now is a good time to start a separate list of which addresses go where. Label 
this list “Cross References" and show the sources of all subroutine calls. As you 
go along, any time that one part of the code refers to another part, add it to this 
list. Once again, do this by hand, even if you have an automatic cross-reference 
Program available. Eventually, you will want this list in numeric order, but for 
now, just list addresses as you run across them. 


PAINT ALL ABSOLUTE JUMPS PINK } 


Ready for a new color? Get the pink highliter and add a pink line for any 
absolute JMP code (54С) or relative JMP code ($6C). Draw the pink line all the 
way across the sheet for in-action jumps. Draw the pink line from the left margin 
to only about an inch past the address for absolute jumps that go out of the 
action. End these lines with half an arrowhead like you did with the subroutine 
calls. 

If the jumps are inside the action, then also put a pink line showing where the 
jump hopped to, just like you did with the subroutines. The jumper and jumpee 
тау be connected vertically along the left-hand edge, but do this only if the two 
are less than twenty lines apart. Also “vote” on the most popular jumps, with 
dots if you see more than one jump going to a single location, Add all jumps 

your cross-reference sheet. 

If the jump is outside the action, use Table 3-1 to try and find out where the 
jump is going to. Then, label the jump using a brown felt-tip pen. 

Here are the two steps that are involved in pinning down an inside-the-action 
jump... 











І 

! — PINK 

От илнэ 20 1F ВЕ JSR  $FDED 
! 

2i 
! 
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Ап outside-the-action jump looks like this . 









(monitor clear EOP) 


BROWN FELT ТІР = 












Notice what is happening? The flow and structure of our program is rapidly 
becoming obvious. We already have all sorts of hints as to which part of the 
action does what. But, we are still nowhere near enough ready to tear into the 
code, 

On an indirect jump using the ($6C) code, go to the address shown in 
parentheses and identify this as an indirect address, and show the location that 
is using it for the indirect jump. 

Let's hack away at our structure some more. 


SHOW THE BRANCHES IN BLUE | 


Get out the blue page highliter and paint each branch (BCC, BCS, BMI, BEQ, 
BNE, BPL, BVC, BVS, but not BIT or BRK) and its address blue. Then, go to that 
address and enter a blue line on the left. Finally, if the branch is less than twenty 
lines up or down, show the branch action with a blue felt-tip pen. Show the 
direction of each branch, and keep any branch lines from crossing. 

Неге is an example . . . 











І 

1 
10 

e5 CMP 523 ! 

920A- 9011 See $9215: 

BLUE ie) 

! 

! 





920C- 2С 65 BE ВІТ $8Е65 
920Е- 70 08 eerie) HIGHLITER 
9211- c6 25 DEC $25 
9213- 20 21 92 JSR $9221 
9216- 4С 70 ЕС JMP $2670 
79219 А5 22 LDA $22 
921B- 85 25 STA 525 
20 24 ЕС JSR  $FC24 (monitor УТАВ Z) - 
9220- 60 RTS 


BLUE FELT TIP 











If you find branch lines that try to cross each other, draw the problem line 
up the right-hand side of the address column or elsewhere as needed. It is very 
important to be able to glance at the listing and tell immediately which branch 
goes where. Е 














58 Enhancement 3 








We аге really into our structure now. Here, the arrows jump forward, condi- 
tionally skipping part of the code. Often, the arrows will go backwards, outlining 
a block of code called а сор. The loops visually leap out at you. Check the big 
опе at $9298. Note that there can be more than one tail connected to any given 
arrow. 

Three refinements. The first thing is to watch out for possibly irrational code. 
If you are in doubt, paint only the mnemonic blue. The second is to label 
branches directly to RTS as an RTS, rather than showing the arrows. Finally, very 
long branches should show each end separately, to keep from getting too many 
lines on the sheets. 





SEPARATE THE CODE MODULES 
FROM THE STASHES 





Now, carefully, look over the action and identify each "holistic" and “ration- 
al" code module. A code module should have at least one obvious entry point 
and at least one obvious exit point. Any question marks or lister mixups at the 
beginning of each module should be resolved so that we can exactly identify the 
boundary of each code module. 

Then, label carefully in red all the external entry points that you know about, 
and any locations that the instructions refer to. Our “cold” entry point is appar- 
ently “OR” which translates to the first code byte at $8DFF. The "warm" entry 
point is apparently “ЗВ”, ог $8E02. The version number is at “ЄВ”, or $8E05. 
We see an “ЙА” here, which apparently stands for version 1.9. 

The “В” mentioned above may be new to you. The “К”” means “relative” and 
is used with relocatable programs. “ФК” is the first byte in the program, regard- 
less of where it sits; 3R" is the third byte, and so on. 

By the way, if some of our example codes don’t exactly fit your listing, 
compare the version numbers. Usually, a different version will move parts of the 
code up or down a few slots from where they first were. 

Here's what this new stuff looks Ке... 





О! RED FELT TIP 


! $8DFF- 4С OE ВЕ JMP %8ЕОЕ COLD ENTRY 
! $8E02- 4С 1Е ВЕ JMP  $8ElF  WARMENTRY 


Ol 58Е05- ОА ASL (Version 1.0) 
1 $8Е06- ЕЕ 22? 
| 88Е07- 92 А 
о BROWN FELT ТІР 





Note that the ASL'rhnemonic is meaningless since we have a very short stash 
here holding the version number. A mnemonic is only meaningful when applied 
at exactly the right place in working code. 

While you are labeling outside entry points, be sure to check the top of page 
Three for warm start, breakpoint, IRQ, NMI, and RESET vectors. These may 
point to important starting or recovery portions of your code. Many newer 
programs will RESET to themselves, rather than to the monitor. The RESET and 
soft start pointers can be a great help in showing you where the “high level" 
code sits. 
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Since НКСС is a utility or a service type of support program, it doesn’t mess 
with the page Three hooks. But this is an exception, so always check. 

OK. Separate your modules and identify all the external access hooks. Identify 
everything else that you know for certain from the program instructions. 

What is left in the action consists of code modules as yet undiscovered—dead 
code, garbage, stashes, or oversights. 

Dead codeis code that is never used. Don't throw any away just yet, because 
it will most likely come to life later. This can happen because you have yet to 
discover some address entry points or else have missed coloring something 
along the way. 

A lot of programmers will leave dead code in their programs so that the next 
code module or file can start off nice and neat on an even page boundary. Dead 
code may also be some location that will be written to later by DOS. Dead code 
will usually be completely rational, but it won't seem to tie in with the rest of 
the program. 

Do not prejudge garbage. It may become most meaningful later on. Most 
programmers try to shorten their code as much as possible, so if it looks like lots 
of garbage is left, chances are you haven't gotten as far as you think. 

Stashes are short code files that have meaning. We will attempt to identify 
many of them in the next section. 

And oversights, of course, are your own doing. 

We now should have identified all of the working code modules, and should 
be able to find most of their access and entry points, their interaction, and their 
exits. Now, we could actually start to think about tearing into the code. 

But no, not yet. Lots of details still remain. Remember that the /onger you hold 
off on finding out exactly what the code does, the easier the job will get, and 
the /ess of it you will have to do. 

Let's see what the stashes and files have to бау.... 


IDENTIFY FILES AND STASHES | 


We have а sort of a chicken-and-egg problem. We can’t tell yet what the files 
are up to since we don't know yet how the program works. And, since we don't 
know how the program works, the program can't tell us yet what the files are 
up to. 

Fortunately, there are several file filters you can apply that can isolate most 
of the stashes and bulk files and tell you their meaning and intended use. Crack 
your files and you have made a tremendous progress. 

Even if you can only crack a few files now, doing so is definite progress, and 
allows moving bytes from the unknown to the known. This is very much like a 
big picture puzzle. Not only does each piece fit somewhere, but it also gets 
removed from the pile of unknown remaining pieces. This makes identifying and 
using the rest of the pieces easier since there are now less of them. 

Let's isolate all the rational code modules and assume that everything left is 
a stash. Things may not be nearly this simple, but let's try it anyway. Fig. 3-9 
shows us the remaining stash locations, 

When you think you have a stash identified, put a narrow yellow stripe up 
the extreme right-hand margin, going over the tractor holes. Eventually, you 
want to end up with a continuous wide line up and down the right-hand side, 
wide yellow for fully known and understood stashes, and wide green for fully 
known and understood code modules. When the last of the white right margin 
disappears, you have conquered your target program. 
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BASE FILE 


GARBAGE 






S8F7D. 


Fig.3-9. Separating HRCG stashes from 


$8748 code modules. 


58Е73 





WORKING 
FLAG FILE 


ЗВЕБЕ. 
АВС 
HEADER FILE 
засаг = 
ps CORE ыш 


MODULE | 
завоз  - 


saorF 


We see a two-slot stash at $8E05, and then another obvious one starting at 
$8E42 on your listing. But, wait. The “Ме” of our stash change dramatically 
at $8ESF. Let's assume we have a second stash starting there. Put а brown dotted 
line all the way across between $8E5C and $8E5F to remind us we think we have 
two separate files. The second stash apparently ends with 58Е73, since $8E74 
holds what looks like rational code, even though this code doesn’t seem to be 
isolated yet. 

We have a long stash starting at $8F48, obviously consisting of lots of question 
marks and the patently excessive use of BCC branches to dumb places. Where 
does this stash end? It's not obvious at first, but let's guess that it ends with 
58Е81. The code starting at $8F82 (that we aren't supposed to be reading yet) 
says to put something in $8E60 and then return. This is rational thinking, particu- 
larly since $8E60 is a slot in another stash and it might end up as a flag in a flag 
file. 

‘Another stash starts.at $92DF, identified by lots of zeros. Again, notice а 
change of vibes at $92EB. The first twelve locations are in three groups of four 
each and all end in zero. The remainder of the stash is strange. Let's call it two 
separate stashes and, once again, add a dotted brown separation line. 

Now comes the tricky part. First, we wantto guess what each location in each 
stash is used for, and, then, we want to пай each location down for sure. 

То do this, make yourself up some file and stash /i/ters. A stash filter is some 
test for some pattern that makes sense to you and to the particular target program 
you are on. The filter is valid if its answer leaps out at you and is clinched by 
some independent test. 
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Normally, you will have to design these filters yourself. Do so very carefully. 
Your choice of filters will vary with the target program and how long it is. Here 
are some obvious filters to try first . . . . 


STASH AND BULK FILE 
FILTERS 


(3 Is it something obvious? 
() Is it an ASCII string? 

() Is it a table of addresses? 
() Is it a group of flags? 

() Is it a conversion table? 
() Is it DOS related? 


0) Does it fill a program need? 





These are the usual filters | try first and the order in which | try them. The HRCG 
is very accommodating in its stash uses. The early tests will tell you a lot about 
each stash. Other programs may not be so easy. 

We attack the chicken-and-egg problem this way. First, we filter the stashes 
and bulk files as best as we can to find out as much about them as we are able. 
Then, we take this information back to the code modules and see what new thing 
this tells us about the modules. Then, we look into the modules and see what 
they tell us about the remaining unknown files 

Three or so trips round and around and we should have things pinned down 
fairly well. Now, if you are into an Adventure or something else really heavy 
with stashes and bulk files, it won't be this simple, but file filtering always makes 
a very good starting point. 

Let's try these filters one Бу one and see what they tell us. 

One example of an obvious file is any code on a display page. This might be 
$0400-$07FF for text or LORES page One, $0800-0BFF for the less common 
text ог LORES page Two, $2000-3FFF for HIRES page One, or $4000-$5FFF 
for HIRES page Two. If any of these pages are in use, the bytes stored here have 
to correspond to the image on the screen. 

Note that the screen images will change as the program is used. What you 
see is the code for the display pages at the exact point in the program where 
you did your listing. Chances are that text page One got messed up by the listing 
process itself. 

Besides their obvious location, the HIRES color bytes tend to be mostly $00, 
$2A, $55, $7F, $80, 5АА, 505, and $FF bytes. In HRCG, we can often ignore 
these for a while, since they are the resu/t of the program and not a part of it. 

Another example of obvious code happens when you are reading interpreted 
BASIC statements. We'll save details on this for another time. But note that the 
basic byte patterns are distinctive, starting with a line number, followed by the 
location of the next program line, and, then, followed by a parsed code using 
token keywords and ASCII symbols, and, finally, ending up with an end-of- 
statement symbol. You can check into the LOADHRCG Applesoft program for 
а quick example. Do this by hex dumping machine code starting at $0800. 

Usually, the BASIC code tells you that you are looking in the wrong place. But, 
machine language is sometimes stuffed inside BASIC programs and, at other 
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times, it will interact directly with the BASIC statements. This happens in the case 
of fast sort routines, variable locators, cross-reference programs, and so on. 

As a much simpler and shorter example of an obvious file, look at $8Е06. It 
is two bytes long. Is it an address? The address is $92FF. Is there anything special 
about $92FF? 

There sure is. 

This is the location of the start of the bulk file that we think is an alternate 
character set. Since we obviously need a pointer like this and since a pointer 
would be early in the program, let's assume this stash is the pointer to the 
character set start. 

Make sure any "obvious" evidence is very strong. Don't make wild guesses, 
and don't make too many guesses at once. Above all, don't force things to fit 
your pet theories about what a stash “һа” to be. In this case, guessing an 
address and having that address reinforce our guess is reasonable. 

Next, try some ASCII filters. The ASCII code is the standard way of stashing 
letters, numbers, and punctuation in your Apple. Table 3-2 shows us the ASCII 
code. An ASCII-coded stash will be mostly code starting with $CX or $DX, will 
have a few $A0 spaces thrown in, and will often end with a $80 carriage return. 
This assumes, as most Apple programmers do, that the ASCII most-significant 
bit is set to a 1. If the MSB is not set, then an ASCII file will be mostly values 
in the forties and fifties, with a $20 for each space, and with a $0D carriage 
return ending. If the file is mostly lower case, then the code will be mostly “ЕХ” 
and “ЕХ” values for а set MSB and "sixties" and "'seventies" for a cleared MSB. 

The actual display code used by the Apple on its upper-case-only old text 
screen differs slightly from ASCII. This code is shown in the Apple manual. The 
code provides for no control characters and offers normal, inverse, and flashing 
upper-case-only characters. 

Programmers rarely use this video display code inside their programs. In- 
stead, they usually will use ASCII, and set and clear the flashing and inverse flag 
(location $0032) as needed. The video display code can only be written directly 
to the screen and must not be output to any other device via the output hooks. 
The code would get used in a program only if the text display needs a wildly 
changing mix of flashing, inverse, and normal characters, and, then, only if the 
upper-case-only text screen is the only intended output. 

Note that ASCII text is automatically converted to video display code by the 
usual monitor routines as it goes onto the screen. 

Now, any file will give you some message back if you filter it for ASCII. The 
key test is whether the message says anything meaningful. You can ASCII filter 
all your stashes and bulk code, but it pays to pick only the most promising ones 
first. 

In the case of the HRCG, we see that the stash beginning at 58Е42 looks the 
most promising. ASCII filter this code and you get . . . 


«dle» HI-RES CHAR GEN VERSION 1.0 «cr» 


This is obviously thé prompt message that first appears under HRCG. The odds 
of it being anything else are insanely small. 

Note as you "crack" a stash, that it no longer belongs to the unknown. 
Further, a cracked stash will greatly simplify tearing apart the actual code, for 
we can now assume the code module directly above it on the listing will be 
involved in printing out this message. 

As you get practice, you'll be able to immediately spot stashes and bulk files 
that will yield useful messages under ASCII code. Be sure to do this by hand a 
few times until you get the feel of this powerful filter. 
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Table 3-2. ASCII Code 











lower hex digit 

о 4 = eee ea о ЁО. 
ч or 8 NUL SOH STX ETX EOT ENQ ACK BEL BS HT LF УТ FF CR 50 51 
ЖЕ: DLE DCI DC2 DC3 DCA МАК SYN ETB CAN ЕМ SUB ВС FS GS RS US 
оол spade ПИ Gs) №. & РТ - р 
h ог B o 1 2 2 4 5 2 7 8 9 $ 1 ‹ = › ' 
к амс d ЗА Persone) ES ЖЕКЕЛЕП 120206) 3, мож 6 
4 or D т 0 к 5 т о y м х М 2 І “ 1 $ — 
ите vow Tb ӨЗИ О №1 cm db а 
l or Е Bo в, IAM RSS cee ДЕ ыл je = joi 














We'll look at some short and powerful ASCII “5поор” programs in а tuture 
enhancement. Commercial programs that list ASCII strings can also be used. But, 
watch out that loading the snoop program doesn't bomb part or all of your target 
code. For now, do your ASCII snooping by hand till you are able to spot an ASCII 
file at a casual glance. 

The acid test of an ASCII filter is whether you get a message back or not. Once 
again, don't force things. If the filter doesn't hit you over the head with the 
answer, try something else. 

If the message seems fragmented or disjointed, possibly you are looking at an 
area that gets written repeatedly by DOS—putting message upon message on 
top of each other. A copy of the keybuffer from $0200-$02FF may also look 
the same way. In either case, you are far more interested in the use of this file, 
rather than its contents. 

Our next trial stash filter should answer the question, “Оо we have a list of 
addresses?" Look at the stash starting at $8Е5Е. A bunch of zeros, with а $92FF 
in it. Recall that 92FF points to the start of the default character generator. Do 
we have a file of alternate character sets here? 

It doesn't look like it, but those zeros suggest а test. Let's run the HRCG and, 
then, let’s load nine alternate character sets. Then, we will see how and if this 
stash changes. 

Try it and there's no change! This should teach us several things. First, always 
be sure you have what you think you have in the machine. Second, be sure and 
try any trick you can think of, even if it doesn’t work. 

Third, and most importantly, NEVER force anything to fit your pet theories. 
The address filter clearly fails on this file. We'll discuss this stash in more detail 
later. 

Let's try an address filter on the next stash starting а! $8F48. Every second 
entry is either a $8F or a $90. Look at it on the hex dump and the addresses 
leap out at you. Color every second address pair yellow on your hex dump. Note 
that the addresses sit backwards on the dump, with the high byte second and 
the low byte first. This low-byte-first style is typical of most 6502 machine- 
language addresses. 
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It looks like we definitely have a table of addresses. For the clincher, check 
to see if the addresses all go somewhere rational. And, we have another surprise! 
Each and every address goes right in the middle of the code allright, but each 
опе seems to point to an extremely dumb place! 

Let's break ош rule on tearing into code for a moment and see what code we 
find immediately above this address table. In this code module, we take a value, 
multiply it by two and, then, use it as an X index to get the high address in $8F3C. 
This high address gets shoved onto the stack. Then, we get the low address at 
$8F40 and shove it onto the stack also. Then, we return from the subroutine. 
What we have really done is we have faked an indirect jump to the selected 
module. 

Now, what does a subroutine return do? It pops the stack twice and goes to 
the address it thought it came from. Only we just changed that with the address- 
low and address-high stack pushes. Note that two pushes and two pops left the 
stack exactly where we started. Our new code module is, therefore, at the same 
level that we were before, so we have done an indirect jump, rather than a JSR. 

Ah! But, a subroutine return does not return to the address on the stack. It 
returns to the address on the stack plus one! This quirk is from the 6502 
Programming Manual. Now, let's try adding one to each address and see what 
happens.... 


$9046 + 1 = $9047, an immediate RTS. 
$8F7D + 1 = $8F7E, a royal mess. 

$8FA9 + 1 = $8FAA, the start of а subroutine! 
$8FD1 + 1 $8FD2, the start of a subroutine! 
$8FEC + 1 = $8FED, the start of a subroutine! 
$901A + 1 = $9018, the start of a subroutine! 





etc... 


Keep this detective work up, and we find that each address, except for the 
first two, points to a subroutine. The first one, an immediate return, looks as if 
it is a mistake. 

What about the royal mess? Here is a classic example of our lister getting off 
on the wrong foot. Right now, the lister says . . . 





STA (BO), Y 
вїт $A9 


??? 
STA $8Е6О 
RTS 





We know the first part of this is wrong, since we have stashed addresses and 
not working code here. We suspect the end of the listing may be right, since it 
seems rational. Our problem address is trying to point to $8F7E, so let’s let it 
do so. Relist things starting with $8F7E, and you get . . 
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$8F7E- 
$8FB0- 
$8F82- 
$8rF85- 


BO 24 
A9 80 
BD 60 BE 
60 


BCS $8FA4 
LDA %580 


STA $8E60 
RTS 





And this is a nice and rational little subroutine. Our problem mess was solved 
by making sure our lister had something worth listing as its first entry. 

Wow, what a bit of detective work. Our filter has found 27 addresses that lie. 
in the middle of our code, all of which point to valid and workable subroutines, 
except for the first one that immediately returns. 

Let's carry this further to see what an address stash will tell us about those 
subroutines. Now, 27 is one more than 26, the number of letters in the alphabet, 
Look at the ASCII code given back in Table 3-2, and we see a sequence of 
@ABCDEF . . . that jumps out at you. If the program was using a pointer that 
started with (9 for a 00 value, we would have 27 values, the last 26 of which 
would be the alphabet in order. Naturally, (9 wouldn't be used, so it would 
immediately return. 

Let's take a wild guess that (2 — Address 0, А — Address 1, В — Address 
2, and so on. Now, let's see if this heads to any place that is useful. 

Back to the HRCG manual. We have two sets of A to Z commands. This 
strongly suggests trying to fit the menu selections to the subroutines we already 
have. Right now, this is sort of a wild guess. But, if it works, and if we can prove 
itabsolutely, we will have chopped mucho time off of our target-program attack. 

Let's look further. Put a brown arrow at each subroutine's starting address that 
we think does something from A to Z. We get strong reinforcement right off the 
bat since all of them start off on a new code module. 

We also notice something rather strange. Each and every module starts off 
with either BCS or BCC. 

Odd. 

But, remember that there are two alphabets needed in HRCG, one for the 
main menu selection and one for the option selection. Let's continue, since 
everything has been reinforced so far. Apparently each subroutine is a subrou- 
tine pair, one of which handles the “таш” menu selection and one of which 
handles the "option" menu selection. Further, the condition of the carry flag tells 
us which way to go. 

Which is which? To find out, we'll need more detective work. 

Note that we have a function selection “Е” but no option selection “Е”. Note 
also that we have an option selection "В", but no function selection “В”. Go 
to the sixth address on the list (E is the sixth character starting with @), and we 
see а BCS to RTS. Apparently a cleared carry is a function and a set carry is an 
option. 

Even more important, look at that monitor subroutine clear-to-end-of-screen 
leaping out at you at $9028 on your program listing. This is а solid and complete- 
ly independent check on what these addresses are used for. 

As a final check, we look at entry “R” (the fourteenth address), and we see 
а BCC to RTS, verifying that the carry flag decides which alphabet to use. The 
code at “R” should “Reverse the overlay” for us. А quick look at this code 
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shows it setting two flags for us—another confirmation. This confirmation is 
much weaker than the first one, but support is support. 5 

So, go through all your code addresses and label their uses with a brown 
felt-tip pen. Use fairly large letters. $8F7E should be labeled “(А) function 
SELECT №. Check the BCS branch location and the code starting at $8FA4 gets 
labeled “(А) option PAGE 1 PRIMARY", 

Continue through the list. The modules that use the cleared carry are func- 
tions, and the ones that use a set carry are options. 

Note the power of the address filter. We now know the meaning and use of 
well over half of the code modules, without tearing into the code at all. HRCG 
is very friendly with its menu-driven selections. In other programs, you may not 
be able to immediately tell one address-code module from another. But the very 
fact that you can break up the modules into little chunks is extremely valuable 
and a major time saver. 

The usual clue to filtering address tables is that every second entry is the same 
and the backwards entry pairs seem to be working through a range in a usually 
increasing order. 

The HRCG stash at 58Е48 seems to be the only table of addresses we have, 
so we will try some new filters. 

Our next trial stash filter asks, “Оо we have a group of flags?” A flagis some 
location that the program refers to so that it can decide what it is going to do 
next. In the HRCG, we can expect flags for the display page, the primary page, 
the working alternate character-set base address, the display mode, and so on. 
In an "adventure" program, the group of flags can show what is in which room, 
whether the giant armadillo is asleep or awake, whether the golden clockwork 
canary can be wound, and similar conditional things. 

A flag file will often be mostly zeros, with а few FF’s thrown in here and there. 
Other hex bytes in a flag file may have only a single bit set, such as $01, $02, 
$04, $08, $10, $20, $40, and $80. Flag files may also hold an occasional 
address or two. 

One good way to verify a flag file is to find some stash that looks reasonable, 
and then /ightly scan nearby code modules to find if there are references to 
these locations. In the HRCG, we see a likely file starting at $8E5F. A check 
through some of the option code shows lots of them working with locations 
$8E5F through $8E73. 

There's usually a two-step process involved in understanding a flag file. First, 
you prove the flag file is there and that it is used. Then, later, when you are 
checking into the variables of the program in the next section, you attempt to 
put specific meaning onto each and every flag. 

Pinning down flag meanings can be quite a challenge. The original program- 
mer started with his flag definitions and locations and, then, built his program 
around them. You have to do the opposite, taking strange code and inferring 
what the flags originally stood for. 

Our "5 it a conversion table?" filter is one that takes some experience to use. 
А conversion table relates addresses to data in some manner. Table lookup is 
a very fast way to do things, compared to calculating values. The stash starting 
at $92DF "looks" somewhat like a conversion table that somehow “seems” to 
be involved with HIRES (high resolution) base addresses. We'll keep this one a 
"maybe" for now. 

Other examples of conversion tables are the shape tables and sprite maps 
used in HIRES graphics. A shape table holds a bunch of drawing directions, as 
needed, to directly write on the HIRES screen, using Apple's graphics routines. 
A sprite map will hold an image of what is to be remapped onto a HIRES screen 
А character from an HRCG character-set file is an example of a sprite map. 
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Let’s continue down the file filter list. Many machine-language programs 
create their own DOS, or else, use DOS variations for protection, access, and 
so оп. In these cases, there аге some DOS filters you can apply to your stashes. 
These DOS filters do not seem to help us here on the HRCG. 

А file involving DOS may consist of bunches of code always ending in 5Х0 
‘or 5Х8. These are used іп the DOS nibble encoding. DOS code modules will 
often use header constants of 505, АА, $96, markers of SDE, ЗАД, $EB, and 
atrailer of $DE, $AA, and 5ЕВ. These values will jump out at you once you tune 
yourself into them. DOS code will also repeatedly use LDA 5С08С,Х com- 
mands, followed by a BNE back to itself. “Х” here is the slot number. This looks 
real dumb when you first see it, but it is a sure sign of DOS read activity. 

Another way to filter a file is to ask, “Does it fill an obvious program need?” 
You'll have to design suitable filters for each and every target program. Let's take 
a closer look at our bulk file and see what we can find out about it from its 
structure alone. 

Visual clues can help bunches here, such as the frequency of repetition of 
some marker. In Zork, the vocabulary file has a zero and, then, six bytes, over 
and over again. The “objects” file takes nine bytes and is in the form of seven 
flags and an address. Look for these patterns. Break up a file into several smaller 
files whenever you see any change іп these patterns. 

Even if you don’t have the foggiest idea about what 15 in the file or how it is. 
used, deduce as much as you can about the file structure, for this will be a great 
help later. 

We suspect our bulk file is a default character set. All right. That means that 
the bits should look like characters if you arrange them just right. We know the 
characters are arranged in 7 Х 8 squares from the ANIMATRIX program. So, 
a reasonable “Does it fill a program need?" filter on this bulk file is making sure 
to look at each and every bit and see if there is some visual pattern that looks 
like character dots. Let's start at $9F00 . . . 


($00) — oooocco 
($00) — cococoo 
($00) — 0000000 
($00) — ссссссо 
($00) — ооооооо 
($00) — ocoooco 
($00) — ocoooco 
($00) — ООООООО 
Now, that one is singularly uninformative. Yet, it is the first character and we 


know that the first noncontrol character in ASCII is a space. Let's try another one 
at $9307. 


($08) — oooecoo 
($08) — 0008000 Е 
($08) — ocoecco 
($08) — сосессо 
($08) — ocoeoco 
($00) — ооооооо 
($08) — coceoco 
($00) — ocococo 
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Now, that looks like an exclamation point, the second printing ASCII charac- 
ter. But, things are still weak. Let's try to predict a quote for the next one, starting 
at $930F. And, sure enough 


($14) — coececo 
($14) — coececo 
($14) — coececo 
($00) — ооооооо 
($00) — соооооо 
($00) — oocoooo 
($00) — coococo 
($00) — oocccoo 


Apparently the characters are in the character file in order, just like they go 
on the screen. Only, we may be jumping to conclusions. Let's try several more 
characters. There are 96 characters, each of which takes up 8 bytes, so we can 
expect 768 bytes total, or exactly 3 pages. Thus, we would expect the numbers 
and punctuation to start at $92FF, the upper-case alphabet at $93FF, and the 
lower-case alphabet at $94FF. 

To prove this, we would expect a capital “А” to be at $93FF + $08 = $9407. 
Try it, and lo and behold . 


($08) — 0008000. 
($14) — с0вовоо 
($22) — ceccoeo. 
($22) — оеосово 
($3E) — сөөөөөо 
($22) — oeccoec 
($22) — овосово 
($00) — 0000000 





50, obviously, we know everything that we should know about the bulk file 
now, right? 

Wrong! 

One very important rule... . 


No matter where you are in 
cracking a file, there is ALWAYS 
опе surprise remaining between 


where vou think you are and 
where you really аге. =+ 





THE FINAL 3 
SURPRISE 15 

ТНАТ ТНЕВЕ АВЕ 

NO MORE SURPRISES! 


Always, check things as independently and as completely as you can before 
convincing yourself that something is so. In the case of our bulk file, the surprise 
comes on the next character. 
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($1E) — cceesec 
(622) — овосово 
($22) — овосово 
($15) — с0вввес 
($22) — ceccoeo 
($22) — cecoceo 
($10 — 00евево 
($00) — oooocco 


Uh — whoops, That's а B all right, but why is it backwards? АЙ the rest аге 
obviously frontwards, aren't they? Let's try the next character 


($ 1С) — ооееесо 
($22) — oeooceo 
($02) — ooooceo 
($02) — со 
(502) — 0000080 
($22) — сөсссес 
($10) — coeeeco 
($00) — ооооооо 


Hmmm . . . , ће "C" is also backwards. But why would some characters be 
frontwards and some backwards? 

They wouldn't. 

The first three characters that we looked at just happen to look the same 
frontwards or backwards. That's the prize we find in this particular box of 
Crackerjacks. 

Apparently all of the characters are “backwards” with the least-significant bit 
going out to the display first and the most-significant bit going out to the display 
last. Think about this for a while and you'll remember that a backwards entry 
is also how all of the HIRES color routines work, so we should have expected 
something like this. 

Fig. 3-10 shows us the final arrangement of the default character set in the 
bulk file. We can safely assume that all other character sets will behave the same 
way, even though they are located elsewhere in memory. 

Now, a visual bit-by-bit check of a long file may turn out to be totally worth- 
less. But, it also may be a sure clue that will permit quickly cracking most of the 
program code. However, it all depends on the program and how creative your 
cracking approach is. What you have to do is make up a “Does it fill a program 
need?” filter that might show you something. But, keep trying things that are 
geared to the target program until something leaps out at you and hits you over 
the head. 

There is one ultimate file filter . . . . 


THE ULTIMATE FILE FILTER 


Fill the file with water and 
see where it leaks. 
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ЖӘКЕ FORMULA TO FIND ANY CHARACTER 


STARTING ADDRESS = $92FF + 8+(ASCII - $20) 


(WHERE ASCII = HEX ASCII VALUE OF CHARACTER) 


EACH CHARACTER 15 STORED AS EIGHT SEQUENTIAL BYTES. 
THE FIRST BYTE HOLDS THE DOTS FOR THE TOP ROW OF THE 
CHARACTER. THE 188 OF EACH BYTE IS THE LEFTMOST 
DOT ON THE CHARACTER. THE MSB IS USED FOR OPTIONAL 
HALF-BIT SHIFT OR COLOR CHANGE AND IS NOT DISPLAYED. 
BOTTOM BYTE 15 USUALLY BLANK, EXCEPT FOR LOWER- 
CASE DESCENDERS. 


searF 

























use цв 
UPPER- 1 + 
CASE ЕЗ 
LETTERS юэ. B ГІ 
al 
on 
22 H 
Li 
ТШ 
NUMBERS =” 





AND 
SYMBOLS 


| 


ТНАГЗА 2 





ssarF 


Fig. 3-10. How the HRCG default character set is stored in the bulk file. 


If all else fails, and you are making reasonable progress elsewhere in your 
altack, try changing some or all of the contents of a file and see what changes 
take place in the program. 

Usually, the program will bomb on random file changes. But, by finding out 
where and when it bombs and, then, zeroing into one or two locations in our 
target file, we can sometimes find out lots of things in a hurry. 

Suppose we didn't know our bulk file was an alternate character set. If you 
made the first eight bytes all $FF's instead of $00's, then all the spaces in any 
message would be white boxes, but nothing else would change. Now, this would 
immediately tell you that the file was a character set and that the first entry was 
a space. 

Another neat example of this is to go through the movable object file in an 
Adam's Adventure and change all the room numbers to БЕР. You are now 
carrying ...... everything! 

The only unexplained file left in HRCG is the stash starting at $92EB. Now, 
this code seems downright weird and has failed all the other tests. The code 
could be garbage since it is at the very end and since the character generator 
sets all have to start at the same base address. 

Fill this file with $FF's and what happens? 

Nothing. 

There is no change in any part of HRCG that is immediately obvious. So call 
it garbage. 

At this point, you should have all your stashes and all your bulk files separated 
and many of them fully identified. 
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Back to the code modules . . . . 


ATTACK VARIABLES AND CONSTANTS | 


Start a fresh page оп your quadrille pad and head it “LIST OF VARIABLES." 

Now, go through the code modules line by line, and each time you find an 
address used for loading, storing, BIT testing, logic operations, or whatever, paint 
the variables pink and the constants green. 

Note that the constants will always have a # symbol in front of them. Page 
Zero addresses will be two hex digits but no #. Absolute addresses will be four 
hex digits, again with no #. 

As an example, an LDA $05 puts what is in page Zero memory location 50005 
into the accumulator. This is a variable. It is a variable since the contents of 
$0005 can have any of 256 values ranging from $00 through $FF. But, an LDA 
#$05 puts the каше hexadecimal $05 into the accumulator. This is a constant 
equal to “бе” of something. 

Watch for that # symbol! It will get you every time if you ignore it. 

Our first code module starts at $8E1E. Your variable and constant lines should 
look like this 











GREEN ~ 


58Е1Е- А9 74 


58Е21- 85 38 


ШК 5878) (low address 74) 
(KSWL) 


RED A х. BROWN FELT ТІР 





FROM TABLE 3-1 SOSEA .. 


OR PREVIOUS 


5057... 
RESULTS we Sub $9158 
Sub $900D `. 


As you identify variables and constants, you can start tearing into code. But, 
if something isn't immediately obvious, go on elsewhere. Our first object here 
is getting a list of all locations that get used for target-program variables. Howev- 
er, if we can find the meanings at the same time, we are just that much further 
ahead. 

The code starting at $8E1F is very easy to read. First, we set the input hook 
to $8E74 and, then, we set the output hook to $8F18. Next, we reconnect DOS 
to internalize these hooks. Then, we switch to the full graphics and pick the 
HIRES mode. Continuing, we restore the default display parameters and, then, 
we switch on the graphics mode. Finally, we exit. 

How did we figure all that out? Look back at what we know about these 
variables. ... 


$38 and $39.....are the KSW switches in the monitor. 
$36 and $37 . are the CSW switches in the monitor. 

. is the DOS reconnect hook. 

„is the full screen switch. 

..is the HIRES switch. 

.is named "Restore Default Parameters.” 
is named “Display Primary.” 

is the GRAPHICS switch. 








$С052 








5С050 
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Usually, you won't be so lucky on your first try. We now understand that this 
„оде module is the initialize portion of HRCG. We also now see what it does, 
We add all the above variables to our variables list, and color everything that 
we understand reasonably well pink for a variable or green for a constant. 

Since this module is so obvious, we can also color the right tractor margin a 
solid wide green. 

We also found out something new. А!! keyboard inputs go to $8E14 and all 
character outputs go to $8F18. So, label these locations in red. Do this and two 
more large code modules now have labels. Call these KEYBOARD ENTRY and 
CHARACTER OUTPLT. 

Continue through the code modules and identify every variable. If you can 
tell exactly what the variable is used for, so much the better. If not, just put the 
variable on the list. The variable will most likely crop up later in another code 
module that may clarify its use. 

Don't go overboard on analyzing code. If something is obvious and simple, 
go ahead and crack the code. If it is not, just record all the variables. Do not 
color any variable or constant till you understand what it is used for. But, be sure 
to get all of them on the list. 

Pay particular attention to variables inside parentheses. A set of parentheses 
means that you are doing a jump indirect or using one of the indexed indirect 


Table3-3. Listof Variables for HRCG 








ADDRESS. MNEMONIC USE 
— раве $00— 
$0020 WNDLFT Leftendofscrolling window 
$0021 WNDWDTH Width of scrolling window. 
$0022 WNDTOP Topoí scrolling window 
$0023 WNDBTIM Bottom of scrolling window. 
$0024 CH Textscreen cursor horizontal 
$0025 су Text screen cursor vertical 
50028 BASL Textscreen base address low 
$0029 BASH Text screen base address high 
5002А BAS2L Dotrow HIRES base address low 
$0028 BAS2H Dotrow HIRES base address high 
50035 YSAVI ‘Temporary Y registersave 
50036 CswL Character output hook low. 
$0037 CSWH Character output hook high 
$0038 KSWL Keyboard input hook low 
50039 KSWH Keyboard input hook high 
$004Е RNDL Keyboard delay low 
$004F RNDH Keyboard delay high 
50058. Temporary X registersave 
$00ЕС HIRES base address low 
500Е0 HIRES Базе address high 
500ЕЕ m Characterset base address low 
$00EF Character set base address high 
$00FF Temporary accumulator save 
— page $01 — 
$0104 JSR stack source pointer (,X) 
— page $03 — 
$03EA Hook toreconnect DOS. 
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Table 3-3 Cont. List of Variables for HRCG 
ADDRESS 5 ММЕМОМІС USE 
— page $8E— 
$8E06 Default character set base low 
$8Е07 Default character set base high 
$8E08 Jump to usersub А 
5808 Jump to user sub B 
58Е42 Pointer to header message 
S6ESF Escape key flag 
$8E60 Alternate characterset flag 
$8E61 Primary page flag 
$8Е62 Inverse video flag 
$8Е63 Transparent video йар Мо. 1 
58Е64 Transparent video flag No. 2 
$8Е65 Scrolling Пав 
$8Е66 Case flag 
58Е67 Character setin use base low 
58568. Character set in use base high 
$8E69 Save of $8661 while block mode 
58Е6А Save of 58862 while block mode | 
$8EGB. Save of $8663 while block mode 
заевс. Save oí $8£64 while block mode 
58:60 Save of $8£65 while block mode 
SBEGE Save of $8£66 while block mode 
$8E6F Save of $8£67 while block mode 
$8E70 Save of $8£68 while block mode 4 
$8671 Block mode flag 
5872 CH Horizontal cursor position. |: 
58Е73 су Vertical cursor position 
$8248. Function addressfile baselow 
$8749 Function address file base high 
— page $92 — 
$920F Startof HIRES pointer file 
592ҒҒ Default character file start 
— page 5С0— 
scooo IOADR Keyboard ASCII input 
$С010 KBDSTRB Keyboard strobe reset 
5С052 MIXCLR Full graphicssoft switch 
scos4 LOWSCR Page | softswitch 
5С055 HISCR Page 2softswitch 
В $6057 HIRES HIRES soft switch 
> $6050 TXTCLR Graphics softswitch 
— page $ЕС — 
$ЕС22 VTAB Vertical tab from CV sub 
SFC24 VTABZ Vertical tab from accumulator 
$rca2 CLEEOP Clear to end of page sub 
5ЕС58. HOME Home text screen monitorsub 
$FC70 SCROLL Scroll text monitor sub 
SFCIC CLREOL Clear to end of line sub 
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odes. These are among the most powerful commands the 6502 microproces- 
-ог has available, so it pays to very carefully understand how these are used. 
It really gets challenging when you get into the double or even triple indirect file 
manipulations that are involved in the longer Adventure programs. 

Don't worry too much about fuzziness and loose ends. Identify what you сап 
and crack what code you can, but keep moving! And, every time you get a new 
piece of checkable information, go back and plug it in everywhere it seems to 
fit. 

Our flag file bytes get identified as you go along. Note that $8FA4 puts a $20 
in 8E61 to display the primary page and that $8FCC puts a $40 in $8E61 to 
display the secondary page. We can then conclude that 58Е61 is the pege flag. 
You can continue this reasoning for the other flags. The block mode ends up 
using the bottom half of the flag file. 

You should end up with a complete list of all variables, some of the code 
completely cracked, and lots of new hints that will help you elsewhere in your 
attack. 

After your list is nearly complete, recopy it legibly in numeric order. Table 3-3 
shows a list of the variables used in HRCG. Use this as an example. 


PAINT THE HOUSEKEEPING YELLOW | 


Next, go back through the code. Every code line that uses an impliedaddress- 
ing mode should be painted yellow once you understand it. Implied mode 
structions use a single op code byte and are not qualified by a value or an 
ddress. Examples аге INX, DEY, TXA, CLD, SEC, Т5Х, and so on. 

If you happen to have code that uses the stack to hold a value for you, this 
will show up with a PHA, some operations, and, then, a restoring PLA. Show 
these in yellow just like any other implied instruction. But if, and only if, the PHA 
and PLA are irrevocably paired as a temporary store, connect them with a 
yellow bracket. 





























Like this... 
1 
o! 
! 8E87- ВІ 2A LDA | (52А),Ү 
! 8Е89- 48 PERILS 
1 ВЕВА- Еб 4E ІМС $4Е ELLOW 
О 8E8C- DO ОВ BNE $8E99 YELLOW 
І ВЕВЕ- Еб 4F INC $4F нените! 
с! ВЕ90- СА рехав 
1 8Е91- ро 06 BNE 58Е99 
1 8Е93- 49 7Е EOR #$7F 
О! 8Е95- 01 2A STA (62А),Ү 
1 8E97- А2 50 LDX 8550 
1 8Е99- 2С 00 co BIT $6000 
о! 8E9C- 10 EC BPL $8Е8А 
! ВЕЗЕ- 68 : " 
! BE9F- 91 2А STA  ($2A),Y 


! 8ЕА1- ВА TSX 
2 
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Once you understand how a yellow line is used, add comments in brown to 
explain it. Should you gét paired PHP and PLP commands, these should also get 
bracketed in yellow, but only if they always work together. 

What you are after here is to have a color on each and every line, a comment 
оп each and every line, and, on the right margin of the page, a solid green area 
for each module that is understood, and a solid yellow area for each stash that 
is cracked. 


WRITE A SCRIPT 


Where you are right now depends on your experience and how tough and 
how long the program is. If you try this method on a target program that is only 
а few hundred words long, you should be done by now. You should not only 
have met your limited goal, but should have the rest of the entire program 
completely cracked. On longer programs, the chances are there is lots of white 
space remaining. These white spaces point to uncracked code and unbroken 
stashes and bulk files. 

The next step is to write a script. Explain in people-type words what each and 
every known stash, bulk file, and code module does. 

А complete script of HRCG appears in Table 3-4. Use this as an example. li 
you have to leave blanks for now, do so. 


CUSTOMIZE YOUR ATTACK | 


Hopefully, you will know what to do next at this point. Go on your own vibes 
in the most obvious direction. 

Obviously, all machine-language programs are different. Some will involve 
themselves a lot with DOS. Others will use only the HIRES screens for game 
actions, Still others will interact with a host BASIC program, and so on. 

What you now want to do is customize the attack to fit the program. How 
you do this is up to you. Here are some things | sometimes пу... 


CUSTOM ATTACK METHODS 


Look for built-in diagnostics. 
Use breakpoints. 
Try flowcharting. 
Attack indirect addressing. 


























Gain partial control. 
Use the cassette. 
Single step and trace. 


Attack the fundamental subs. 
Ask for help. - 
Use partial boots. 


Detect changes 
Alter files. 
Put program on an assembler. 


Attack а similar program. 
Decipher special codes. 


) 
) 
) 
) 
) 
) 
) 
} 
} Chip away at it. 
) 
) 
) 
) 
) 
) 
) 
) 
) Try something easier. 
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That's sure a long list. Not every idea will work on every program, though 
Let's look at a few of these in more detail. 


Table3-4. Complete Script of HRCG 








ADDRESS COMMENTS 
$8DFF - Hard entry point. Clearsscreen and 
prints header, connects HRCG hooks. 
$802 - Soft entry point. Connects HRCG but 
doesnotclearscreen. 
58605 - Version number x 10. 
58Е06-8Е07 - Base address of default character- 


generator set. Defaults to $92FF. 


58Е08-8Е09 - Usersubroutine A starting address 
called by option Y. Defaults to 
subroutine return RTS, 


58ЕОВ-ВЕОС - Usersubroutine В starting address 
called by option Z. Defaults to 
subroutine return RTS, 


58Е08-8Е1Е - Hard entry routine. Sets МО hooks, 
thenreconnects DOS. Switches to 
HIRES full screen, Restores DOS 
and default parameters. Displays 
primary. Switches to graphics. 





$8Е42-ВЕ5С - Stash holding ASCII-coded title. 
and version. Used during cold entry. 


58Е42-8Е73 - Stash holdingall working flags— 





SBESF - $80 if previous key ESC 
$00 otherwise 
58860 - $80 if alternate characters 
$00 if default characters 
58561 -$20 if page 1 primary 
340 if page 2 primary 
38562 - $00 if normal video 
$7F ifinverse video 
$80 if overstrike video 
$C0 if complement video 
58663 - $80 iftransparent mode 
$00 otherwise 
58564 - $60 iftransparent mode 
$00 otherwise 


58565 - $00 ifscrolling 
SFF if wraparound 
58566 - $00 if caps lock 
- $80 if lowercase 
= - SCO ifsingle capital 
$8E67 - Base add low of set in use Эн 
58668 - Base add highofset in use 





$8Е69 - Save of $8E61 while block 3 
$BEGA - Save of $8E62 while block 
$8E6B - Save of $8E63 while block 
SBEGC - Save of $8E64 while block 
$8E6D - Save of $8E65 while block 
ВЕЕ - Save of $8E66 while block 
$BE6F - Save of $ВЕ67 while block 
$8E70 - Save of $8E68 while block 
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Table 3-4 Cont. Complete Script of HRCC 








ADDRESS COMMENTS 





$8E71 - $00ifnormal display 
$FF ifin block mode 

58Е72 -СН horizontal position 

58573 - CV vertical position 


58Е74-8ЕАС - Enter HRCG via keyboard hook. Save 
A, X, BASH, and BASL. Debounce keyboard 
and flash cursor till key is pressed 
Reset keyboard strobe. 


58ЕАО-8817 - Check keyboard for FSC or CR. И 
ACR, process via sub $928D. If 
an ESC, process |, |, K, M ior 
cursor motions. Then, clear EOL if 
Eorclear EOS if F. Process А, В, 
C, and D cursor motions. 


$8F18-8F27 - EnterHRCC via output hook. Save 
А X, and Y. Ға numberand 
preceded by ESC, change character- | 
set number via $8F86, Ї a control | 
command, clear Carry Ға function 
andset Carry ifan option. Ifa. | 
letter from @ to Z, process by | 
getting address from stash $8748 
and doingan indirect jump. 


$8F48-8F7D = Stashof27 addressesfor menu 
selections A-F. Selection (0 does 
an immediate RTS. Address picked 
by S8F28. 


58Ғ86-8ҒАЗ 200 Function A. Alternate character et. i 
Ifa number from 0-9, calculate new 
base address and store in $8E67. 





58РА4-8РА9 Option A. Put #520 in flag $861 to ч 
switch to primary page 1 
58РАА-8КС8 — - Function B. Begin block display if 


notalready there. Put $#FF into 

flag $8671. Move flags $861 

through $8667 to 58269 through 58Е70 
as temporary save. Move CV and CH 





into flags 58Е72 and $8E73. 
$8FCC-8FDI - Option, Put#$40 in flag 58661 to 
switch to primary page 2. 
$8FD2-8FDE = FunctionC. Carriage return. If 
notbelow bottom, do CR via $9204. 
58ҒЕ2-9ҒЕС - OptionC, Complement display by making 


flag $8E63 a #5СО and $8E64 a $00. 


$8FED-900C -  FunctionD. Block display off. If 
in block mode, move flags back to 
$8E61-8E68. Reset block flag and 
CH flagto zero, CV flag to bottom. 


$900D-901A ^ - Option D. Display primary. Switch 
to page One. Check primary flag, 
and switch to primary flag page. 


59018-9022 - Function E. Clear HIRES page to EOL 
using $9280. Then, cleartext page 


using monitor CLEOL. 
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Table 3-4 Cont. Complete Script of HRCG 











ADDRESS COMMENTS 
$9023-902A -  FunctionF. Clear HIRES page to EOS 
using $927A. Then, cleartext page 
ig monitor CLEOS. 
$9028-903F Unsupported function H. Co loft 


onecharacter if entry at$9028. If 
screen left, go upone!ine. 





39040-9047 - Function. Set inverse video flag 
by putting #575 into $8E62. 
$9048-904F - Function К, Setcaps lock flag by 
putting #500 into $8E66. 
59050-9057 - Function L. Setlower-case flag by 
putting #580 into $8E66. 
$9058-9072 Unsupported function M. Apparently 
ascroll diagnostic, once reached by 
CTRLS,CTRLC. 
59073-907А - Function М. Set normal video flag, 


by putting #$00into8E62. 


59078-9082 - Function O. Set option flag by 
putting #540 into $8E60. Next key 
will complete option command. 


$9083-908D. - . Option O. Pick overstrike mode by 
#500 into 8E63 and #500 into 8664. 


5908Е-9095 - Function P. Clear HIRES page via 
$9270 and text page via monitor 
HOME. Note that an image of the 
HIRES screen із puton text page 1. 


59096-909Е -  OptionP. Pickprin mode by 
putting #500 into 58Е63 and $8E64. 


$909F-90AD_ -  FunctionQ. Homecursor inside 
text window. Move upper-leftvalues 
to CH and CV. Then, reset text 
screen via monitor VTAB. 


$90AE-908A -  FunctionR. Reverse overlay by putting 
%5С0ігіо58Е63 and 8560 into $8E64. 





5908В-90С2 - Function S. Shift nextcharacter by 
putting #5СО into flag 58566. 


$90C2-90C8 - Option S. Pick scroll mode by 
putting #600 into lag $8E65. 


590С9-9005 -  OptionT.Set transparent mode by putting 
#580 into 58ЕБ3 and #$60 into 58Е64. 


$90D6-9103 - Function Y. Textwindow, upper left, 
by resetting WNDLFT and УУМ ОТОР. 
after check for on-screen values. 
Transters ver | position to CV 
flagif not in block mode. 





$9104-9124 - Function W. Text window, lower right, 
by resetting WNDWDTH and WNDBTM 
after check for on-screen values. 























о OOO 
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Table 3-4 Cont. Complete Script of HRCG 





ADDRESS 


COMMENTS: 





59125-912А. 


39128-914Е 


3914Ғ-9151 


39152-9177 





$9178-917A. 


9178-9196 


$9197-91C4 


$91C5-91F7 


$91F8-9220 


$9219-9220 


$9221-926F 


Option W. Set wrap mode by putting 
#$FF into $8F65. 


Function Y. Open to fulltext 
screenby putting #$00 into WNDLFT 

and WNDTOPand 9528 то WNDWDTH 
and 5818 into WNDBOTM. Save as 

CH and CV flags if notblock mode. 


Option Y. Call usersubroutine A 
by jumpingto jump command stored 
at $8E08. Defaults to RTS. 


Function 2. Restore defaults. 

Reset all flags to #00. Set full 

text window. Pick default character 
set. Display primary page. Reset 
usersubsto RTS. 


Option 2. Call user subroutine 
by jumpingto jump command stored 
at $8E0B, Defaults to RTS. 


Begin character entry. Exit RTSif 
option flagset. Check case mode 
and change to upper case or reset 
shift flag if needed. 


Continue character entry. Calculate 
character location and save as ЕЕ 
and SEF. Calculate screen base 
address location and save as БЕС and 
SED. Thisisthetop dot row for any 
character position, The running dot 
том address gets held in $2A and $28. 
Then, the characteris saved on page 
Oretext screen. Like so 





$28-29-textscreen base address 
52А-28 - HIRES dot row address 
SEC-ED - HIRES base address 
SEE-EF - Character-set base address 


Continuecharacter entry. Foreight 
dot rows, get the characterdots and 
inverse ifneeded. Get the dots 

already on the screen; then, AND or OR 
with character dots if needed. Then, 
return resulto ћеѕсгееп. Next, 
calculatethe address of the next 

lower dotrow and repeat till all of 

the characters have been entered. 


Move cursor. Go one to the right 
unless at extreme rightofthe window. 
lfa CR is needed, godownone те 
unless at extreme bottom of window. 
Hat bottom, check flag for scroll 

or wraparound, and continue. 


Wraparound mode. Set WNDTOP to top 
of text window. Do a monitor VTABZ 
torecalculate base addresses. 


Scrolling mode. Dotlinesource is 
52А-528, Destinationisaddiess 
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Table 3-4 Cont. Complete Script of HRCG 


ADDRESS COMMENTS 


SEC-$ED. Destination is eightdots 
above source. Starting at thetoo 
ofthe screen, scroll downward, 
loading from ($2) and storingat 
(ФЕС). Y register handles CH. 
position, stepping from WNDWDTH 
downward. X register handles. 
position of eight rows per character. 
Oneentiredot row is entered, then 
another until done. Afera lineis 
remapped, the base address of the 
nextlineis calculated, makingthe 
old source the new destination, and 
calculatinganewsource. This 
continues until the entire screen is 
mapped. The bottom line is then 
cleared via $8E63. 








9270-9279 Clearscreen. Set CV to WNDTOP 
and CH to WNDLFT and continue via 
$9276. 


$917A-918C Clearto end of screen. From 
present CH and СУ, clear to EOL 
via $9291 as often as neededto 
empty screen. 


59280-92СА Clearto end of line. For eight 

dotrows, calculate address, then 

remove character from screen. 

Inverse backgroundif needed. Y 
register works from CH to WNDWDTH 
doing one dot row at atime. X 
register handles dot rows, working 
fromtop of character down. 


592С8-920Ё -Calculate HIRES base address. 
Divide CV bytwo. Gointothe 
table in $92DF-92EA and lookup base 
address value. Process thisvalue 
and storein $2A and 528. 


$92DF-92EA, = Astashof table lookup values used 
to calculate HIRES base addresses 
needed by $92CB or $92CD. 

$92EB-92FE -  Apparentlyunused garbage. 


$92FF-96FE Bulk file of defaultcharacter set. 


Holds dot pattems of all ASCII 
characters. The seven least 

significant bits hold the horizontal 

dot pattern IN REVERSE foronedot 

line. Eight successive bytes hold 

the dot pattern for one character, 

“arranged from topto bottom. 

Locations $92FF-93FE hold numbers е 
and symbols. $93FF-94FE hold 

upper-case alphabet, and $95FF-96FE 

hold lower-case alphabet. Bottom 

dotrow isblankexcept for 

 descenders. 96 characters total. 





original author may have had some of the very same problems you did. And, 





If you are attacking a very complicated target program, chances are the 
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if he was smart enough, he just, possibly, may have built in some p 
solving diagnostics. — ^ 

For instance, the Adam adventures have a “Possible” and а "Did" tracing 
debugger that you can access with two keystrokes. Zork includes a hook that 
lets you stop the action after each code module, and print out whatever you like, 
such as the files just accessed. Zork will also give you a complete list of rooms 
with just a few keystrokes. A few minor changes to Wizard and the Princess and 
you get a guided tour of all the rooms. 

Be on the lookout for any diagnostic helps that may be built into the program. 
Then, see just how you can tap them. 

Breakpoints are another way to tackle a program. What you do is reach into 
the target program at a place where you want it to stop, and insert a $00 or ВЕК 
command. When the Apple reaches this point in the program, it will stop and 
immediately do a software interrupt. 

What happens next is decided by which monitor ROM you have in use. If you 
have the old ROM, the break puts you in the monitor and displays all of the 
working registers. If you have the autostart ROM, the ВЕК command does а 
jump indirect to the address contained in locations %03Ғ0 (low) and $03F1 
(high). You can go from this address into the monitor, or else, directly to another 
snoop program that spells out what each and every pointer and indirect address 
is up to. 

There is one clinker in the works when you use BRK. You might need the old 
ROM to gain control of the program so that you can change $03FO and $03F1, 
and then switch to the autostart one. А “protected” program under autostart will 
never let you get down into the monitor or change any locations. Use of either 
ROM card with a hardware change-over switch often can get you out of this 
bind. 

А breakpoint сап be used as anything from a scalpel to а cannon, depending 
‘on what you want to do and how large а hole you want to blast in the target 
program. 

Drawing a flowchart may help you. | don’t use that method too much since 
it sounds like something the dino people would want you to do. 

The addressing modes that give the 6502 microprocessor its extreme power 
are the indirect ones. These include jump indirect, indirect indexed, and the 
rarely used indexed indirect. All of these are identified by an address іп paren- 
theses following the mnemonic. A lot of setting up is needed to use these 
locations. Most often, an address pair on page Zero has to be set up ahead of 
time. 

Understanding the rea/ address used for an indirect instruction can be the key 
to cracking tough codes. It pays to spend lots of time being sure you know 
exactly where these addresses are going to and the reasons that they are doing 
80. 

Things really get interesting when you get involved іп double and triple in- 
direct addressing, as is common in adventure programs. The code may go to 
some base address, pick an address pair out of a file there, and use that address 
as an indirect pointer in another instruction. If the files happen to be longer than 
256 bytes, then double indirect is needed, rather than a simple indexed instruc- 
tion. 

Patience and practice are essential to cracking indirect codes. If all else fails, 
replace the indirect op code with a BRK command. On the break, get into the 
monitor and check the locations used to hold the indirect address. 

Hooks are attachments you make to the program to gain partial control. You 
might write your own small “host” program and let it "borrow" subroutines off 
the target program. This is one possible way to dump files off protected disk 
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tracks. Once you are able to use and control key subroutines in the target 
program, you are well on your way to solving everything else. 

The tape cassette is often ignored. Yet the tape system is a very valuable tool. 
One “protection” scheme used involves putting a program in the same space 
where Apple DOS 3.3 would normally reside. A custom DOS is then put 
somewhere else and there is no immediate way to save the program entered 
under DOS 3.3, since booting the DOS 3.3 overwrites and, thus, destroys the 
program 

But, the cassette doesn't саге. It сап save any code іп any location at any time. 
One thing you can do is move the target code down in memory below DOS, 
save it to cassette, and then boot the DOS. Save this lower version on DOS and, 
then, add а “move” command that puts it back where it wants to sit. 

Cassettes are also useful in upgrading between various DOS versions. They 
are slow, unreliable, and unwieldy, but they just might work if all else fails. 

The single-step and trace features on the old monitor are very useful on some 
parts of some programs, particularly if you dump them to a printer. But watch 
out that you don’t try to trace a delay loop, such as the one that waits for a disk 
drive motor to come up to speed. The trace operation slows things down some 
10,000 times from normal speed, 50 а two-second delay will take several days 
and miles of paper to print. Sometimes you can break into the loop, reset the 
counter locations, and continue. Other times, you'll have to combine single step 
or trace with breakpoints. Run the code till you hit the breakpoint, and then 
single step from there. 

Tracing to a printer is one very good way to crack indirect addresses to find 
the files that they work with. 

Beware of tracing parts of programs that read the screen, since tracing and 
displaying can interact. For instance, a clear-to-end-of-screen will hang during 
a trace, since trace keeps resetting the screen locations. If you are printing, defeat 
the screen echo during these times. 

Another custom attack method is to chip away at the target. Your goal may 
seem to be hopelessly buried in the middle of stuff that seems so complicated 
that it will take you forever to understand. If all else fails, attack the easy stuff 
on the outside. Do this even if the easy stuff seems to have nothing at all to do 
with your goal. The parts of the code that outputs characters or inputs data are 
usually easy to read. Continue carving away on anything that looks like it might 
shake loose. What this indirect attack does is reduce the size of what is left to 
a point where you can hack at it directly. 

A big plus for the indirect attack is that it can show you the program author's 
style and where his head is at. Does he use self-modifying code? How does he 
handle multiple choice addresses? Does he use the indirect commands effective- 
ly and gracefully? Is he using mostly branches, or mostly jumps? How elegantly 
or how clumsily does he handle 16-bit addresses and long files? Does he exten- 
sively use the existing monitor, DOS, and BASIC subs, or is he reinventing the 
wheel? How clean is his organization? Is the program designed from the ground 
up for an Apple, or was it obviously modified from a program originally designed 
to run on some inferior machine? Answers to these questions can simplify very 
much the cracking of the rest of the code, since most decent programmers tend 
to be consistent in how they do things. 

If the code seems ridiculously obscure, attack the fundamental subroutines. 
These subroutines are the ones that won the popularity poll (the ones with all 
the dots). The subs to hit first are those that will not call any other subroutines, 
but will go ahead and do direct and obvious things. Common things that funda- 
mental subroutines will do include searching a long file for a value, calculating 
an address, or making a hex-to-decimal conversion. 


ша 
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Once you understand these fundamental subroutines, you don’t have to go 
through them each time they crop up, since you know what they do. Create 
meaningful names for these fundamental subroutines and they will help you а 
lot in your attack. 

Asking for help is an obvious thing to do. There is nothing more infuriating than 
having an 8-year-old boy, just in from off the street, make some casual comment 
that completely sums up what it just took you months to find out the hard way. 
So discuss the target program and its attack. Don’t only do it with “experts,” 
but rap about it to anyone who will listen. Chances are their heads are in other 
places and might put things in a new light for you. 

The python force feeder takes some special hardware, but it can be very 
effective. A force feeder is some hardware and software modifications that 
include a super-powerful bus driver, say a 745245, or maybe three of them іп 
parallel. When you tell it to do so, it substitutes its own code for what the 
‘computer is supposed to be working with. 

For instance, even the old monitor ROM can't help plowing part of the display 
page, the first few keybuffer locations, and part of page Zero when itis activated. 
A sneaky programmer can hide things in plowable locations. But not so with a 
force feeder. Besides being able to force a monitor reset any time you like, a 
force feeder can substitute anything at any place in the program. It can also 
move copies of plowable locations to unplowable ones for analysis. 

As a much simpler example of force feeding, consider the “top display line” 
copy protection hoax. What you do is switch to HIRES and, then, put a key jump 
or some other “тавс” code that you want "hidden" on the top line of text 
display page One, starting at location $0400. This code is called early in the 
program and the program bombs if the code is not there. Naturally, the code 
gets erased immediately after use 

This, in theory, makes any messing with the program impossible. Any tamper- 
ingatall will scroll up the display page and destroy the magic code. Sounds both 
bulletproof and infuriating. 

In reality, this is only a “seven-second” copy protection. What you do is force 
feed the Apple by making it display only text page One, and this "hidden" code 
actually leaps out at you, shouting to be heard. To force feed the page One 
display, remove integrated circuit F14 and ground pin No. б of the socket at F14. 
The hidden code will appear in Apple video-screen code, rather than op code, 
but if you got this far, that just adds to the fun. 

Similar force-feeding games can be played with most of the Apple soft switch- 
es that are needed for analysis or debug. 

‘Another handy debug trick is the partial boot. Instead of letting the target 
program completely boot, you only let it go so far and, then, analyze what you 
have. This catches code modules before they are moved to cover DOS, and so 
on. For instance, the program, Pool 7.5, is generally considered to have excep- 
tionally good, or “three-hour,” copy protection. But, use а partial boot and the 
“three-hour” protection drops down to а much more convenient “eighteen- 
minute” protection. 

The trick here is to carefully watch the disk drive with the cover off and 
timeout the different parts of the loading and protecting process. 

By the way, there's one sure-fire way to read any disk at any time. Just glomp 
a logic analyzer, with a 6502 personality module in it, onto the CPU and you 
are home free. Unfortunately, you can buy a dozen Apples for the price of one 
better grade logic analyzer, so this ultimate weapon does not see much use. 

Change detection is another interesting attack method. However, | haven't 
fully explored this one. What you do is dump part of memory, run a portion of 
the target program, and then see what changed. By finding out how, when, and 
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why that change took place, you can often gain all sorts of insight into what is 
going оп. 

Some day, | would like to build the ultimate. change detector. This would take 
а DMA modification to the Apple that would let a second. Apple or some type 
of dedicated hardware give you an instant and separate. Picture of memory 4 
activity while the main program was running. One display would show what the 
Program was doing, while the second would show you each and every memory 
location of interest. Ideally, such a program should present any location or any 
block of locations that you want and would clearly identify them. With this 
ultimate change detector, you could actually watch the program while it was 
doing its thing. 

A variable-speed feature would also be nice here, so you could slow down 
or stop key activities without waiting forever for them to get through а delay loop 
or whatever. 

We've already seen how altering files can tell you lots of things in a hurry 
about your program. Sometimes you are shooting in the dark since some file 
locations may only rarely be used or might be used only in an obscure way. File 
changing is certainly worth a try. 
` If you are going to change the target program or interact with it, it might pay 
to put the program on your own assembler and create your own source code. 
This lets you add your own hooks and make changes of your own choosing 
inside the target program. The EDASM on the DOS Toolkit is ideal for this. 
Assembling your own source code backwards from the object program is quite 
3 hassle, though, and you shouldn't try it unless you have pretty much cracked 

verything else. Disassembler programs are also available that will capture" 
code for your favorite assembler. 

Sitting on your program is often overlooked. Just walk away from the attack 
for hours or days, and things that should have been obvious all along will leap 
out at you. Let your subconscious work on the puzzles that are holding you up. 

It works, 

Another thing that can help is to try attacking a similar program, either by the 
same author or by one that does the same thing in a simpler or easier-to- 
understand way. The insights you get from one program will help you attack the 
other program. 

Deciphering special codes may be needed in longer adventures. These codes 
are more often used to make code more compact than they are to purposely 
“hide” the meanings of what they hold. The trouble is that most compaction 
Schemes used also do а most thorough job of masking everything that the file 
holds. 

For instance, in Zork, the ASCII strings are compacted so that two bytes hold 
three characters. Some newer adventures use paired letter or similar codes to 
remove the redundancy from text messages so that long text files will fit inside 
the machine. This is how the Co//ossial Cave adventure from Adventure Interna- 
tional manages to get everything that once demanded a mainframe dino into a 
48K Apple without needing repeated disk access. хө 

About the only way to attack these codes is to go into the code modules that 
decipher them. Then, decipher the decipheree. Single step, trace, or breakpoint 
access code modules till they show you how to read the file. Usually, there will 
be some obscure command or program feature that will do things a lot faster 

= simpler than the others. Trace this command or feature out and let it crack 

е code for you. 

The last resort, of course, is to give up. Go back and attack something that 
is simpler. Ё 

Му first machine-language attack of a major program was Adam's Pyramid 








Tearing Into Machine-Language Code 85 














of Doom. This was done in a wilderness firetower using nothing but а 6502 
pocket card. It literally took all summer, but it led to this attack method, and 
there is no better way to learn machine-language programming. 


CONVERGE ON YOUR GOAL | 


Just as soon as you have the structure pretty well defined and ав soon as you 
have cracked most of the code modules, return to your original goal and solve 
that particular problem. 

Our goal in HRCG was to find the scroll hooks. By now, they should leap out 
at you. 

Just as the cursor is about to go off screen at $9208, a check is made to see 
whether scrolling or wraparound is to be used. If scrolling is active, $9213 does 
a jump to the scroll subroutine starting at $9221. Specifically, $9214 will hold 
the /owaddress and $9215 will hold the high address of the scrolling subroutine. 

Just change these hooks enough so that you can use your own scrolling 
subroutine. 

Summing ир... 





The HRCG scroll hook is at $9214. 
$9215 holds the address low of 
the scroll subroutine. 


$9216 holds the address high of 
the scroll subrouti 


The existing scroll subroutine starts 
at $9221 and ends with 
$926F. 





Easy, wasn't it? 
If not, go through a few practice target programs and see how fast and 
powerful this method can be, 


WRITE IT DOWN | 


Surely you don’t want to go through all this а second time on the same target 
program. So, carefully write down everything you learned in some form that 
works for you. 

Make a clean copy of your analysis on the second listing you made. Also, 
make a neat new table of variables, a new cross-reference, and write a complete 
new script. Put most of this information onto disk so that you can have printable 
and updateable copies for later use. 

The insight that you have now will be long forgotten in a month, Be sure that 
you will be able to later recover what you already have done, and will be able 
to do so both quickly and hassle free. See. 

Resist the urge to pull a “EUREKA! I have found it!” and run off with only your 
limited goal met. Do so, and the key information will disappear down the tube 
somewhere and all will be lost. 

The following outline sums up all the steps involved in tearing into machine- 
language code. Go back over them, and you'll find three parts to the attack. First 
you prepare yourself, then you attack the target program, letting it reveal itself 
through its form and structure. Finally, you customize the attack to reach your 
goal. . 
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Неге is а quick summary of the tearing method. . . . 


TEARING INTO 
MACHINE-LANGUAGE 
CODE 





PREPARATION 


Assemble the toolkit. 

Grok the program. 

Go to the horse's whatever. 

Set a limited goal. 

Empty the machine. 

Find where the program sits. 
List and hex dump the program. 


ATTACK 
Separate action from bulk files. 
Paint subroutine returns green. 
Paint subroutine calls orange. 
Paint absolute jumps pink. 
Paint relative branches blue. 
Separate modules and stashes. 
Identify files and stashes. 
Attack variables and constants. 
Paint housekeeping yellow. 


FOLLOW UP 
Make a list of variables. 


Write a script. 
Customize the attack. 


Converge on your goal. 
WRITE IT DOWN! 





Practice makes perfect. Try ite 








Tearing Into Machine-Language Code 87 











1 WILL THE REAL LISTING PLEASE JUMP OUT? 








There are times when the disassembler in the Apple monitor lies like a rug. 














A disassembler always assumes it is working with valid op codes. It starts with the first code 
byte it finds and, then, decides what operation the Apple isto do. Depending on the particular 
ор code, one, two, or three bytes will be needed to complete the operation 

For instance, the CLC or clear carry command is an implied addressing instruction handled 
with a single byte. No further information is needed. Тһе LOX #05 immediate command takes 
two bytes, one to tell you what to do and one to answer “How much?" The STA $4050 com- 
mand uses absolute addressing and takes three bytes, one to tell us what to do and two bytes to 
answer "Wherei" by giving us address low and, then, address high values. 

Thus, adisassembler will automatically jump one, two, ог three bytes to get to the start of the 
new instruction. The disassembler always assumes itis working with valid code from a legal 
starting poi 

Ifeither the starting point is wrong or if what isbeing disassembled is not legal code, the “lis- 
ter” starts lying. 

Suppose we have these bytes stashed in memory . ~ 











$0800- 80 8D AD 02 А5 18 EA 


Here is what you get if you try to disassemble this code from various starting points, 








50800- 80 т 

50801- 8D AD 02 STA $02AD 
$0804- А5 18 STA $18 
$0806- EA МОР 
$0801- 8D AD 02 STA $02AD 
$0804- А5 18 STA $18 
50806- ҒА МОР 
$0802- AD 02 A5 LDA 5А502 
$0805- 18 ас 
50806- ҒА NOP 
50803- 02 т 

$0804- AS 18 STA $18 
50806- EA МОР 










We see that we get a different disassembly every time, depending on where we start from. 
Which one is correct? 

The correct disassembly is the one that begins with the first valid op code on the list. The first 
valid op code is often pointed to elsewhere in the program by a jump, a branch, a subroutine 
call, or an external entry point. 

You can expect the “lister” (о іе about one-half of the time when it comes ош of a fileordead 
code and starts into legal code. 

Usually the "lister" will correct itself after two or three wrong entries. So, you usually only 
have to worry about the first few entries into valid code. 

V what you have just listed seems dumb, try listing from one above or one below where you 
thinkthe legal code starts. Most of the time, there will only be one rational and sensible starting 
place and the valid code will leap out at you. 


But remember that the “lister” will only tell the truth when it has both true code and a true 
starting point to work with. 




















Enhancement 


FIELD SYNC 





А one-wire hardware modifi п 
that makes for stunning new апі- 
mation and graphics action ef- 
fects. Now, you can exactly lock to 
video timing for split screens, 
high-accuracy light pens, and 
much more. 


FIELD SYNC 


This enhancement is so horrendously powerful that it's scary. 

It is a one-wire plug-in modification to your Apple that gives you field sync 
and opens up so many mind-blowing new possibilities that we can’t even begin 
to hint at them here. What field sync does is lock your display to your program. 
You can now flip soft switches, update display screens, or change pages while 
the screen is on its vertical blanking return trip. You can also keep ahead of or 
behind the live scan lines to keep your display from mixing “о” and “пем/” 
stuff at the same instant. 

Ага, we will show you а brand new and incredibly powerful software method 
to lock to your video field timing that is exact to a fraction of a microsecond. 
This exact sync lets you mix and match display modes, both dynamically and 
“on the fly” for splits or wipes in any direction. Exact sync also can eliminate 
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0% of the parts and the hassle needed for a fast and precision Ї реп ог for 
a touch screen. Ч 

So, what else is field sync good for? 

For openers, gone forever are any glitches, flashes, and garbage that whip by 
at any time that you change an Apple screen mode. Field sync is the key to 
smooth, glitch-free animation without any collision or dropout effects. Here is. 
the path to smooth-moving gentle scrolls that let you read things as they move 
up the screen. Here, also, are spinners and other action animation made totally 
continuous and smooth acting. 

Want 3-D graphics? Want lots of different single-line colors in HIRES that cross 
and overlap in any combination? Want to mix LORES and HIRES? Or, want to 
mix and match text and LORES all over the screen? Or, all three? How about 
a mixed graphics mode with the text at the top? Or, in the middle? Or, graphs 
with quickly changed labels in both the X and Y direction? 

Are you into animation? Field sync lets you compute and display at the same 
time on the same page without any glitches, dropouts, sugar, or other hassles. 

What about some video wipes that smoothly move one page off the screen 
to reveal a second hidden page, done in any direction, at any speed, in any 
combination? Or, a choice of hundreds of LORES colors? How about a bomber 
flyby or a road race, smooth, fast, and alias-free? 

Need some grey scale? Sure thing. How about some game symbols that mix 
a pair of ordinary text characters into a single symbol? Text over color? Naturally. 

Maybe you would like a full color HIRES adventure where the text optionally 
"floats" in front of the graphics display. This is trivial with field sync. 

All these only scratch the surface. We haven't even begun. And, it's real 
spooky to even think about what will happen when a really good programmer 
gets his hands on this mod. 

And, best of all, it is back to the drawing board for you Atari people. Apple 
wins this round of ^Whose-got-the-best-color-graphics!"" bytes down. 

In this enhancement, we will look at what a field sync modification is and how 
you can make one. We will also give you some very simple yet powerful support 
software. We'll then spend much of the rest of the book exploring a few of the 
more blatantly obvious uses of field sync. 

Total cost of the enhancement is around $2.00 and can be done in a few 
minutes. The modification will not void your Apple warranty and is completely 
removable. The support software, even that needed for an exact lock, takes only 
a few machine-language bytes and is easily reached from any language. 


WHY SYNCHRONIZE? 


Every personal computer designer faces the dilemma of how to compute and 
display video at the same time. The timing and video signals sent to your monitor 
ог color tv are extremely critical and must be there all the time. Even the briefest 
mixup or delay, and you end up with a twisted, torn, or missing picture. 

Apple solved this dilemma in a brilliant way. Check into the 6502 micro- 
processor timing and its memory-access activities, and you find out that the CPU 
only accesses memory оп one half of each of its clock cycles. The Apple's clock 
cycle is slightly under one microsecond. Of this time, the 6502 microprocessor 
used as the Apple’s CPU must have unrestricted memory access for only half 
of each microsecond. 

On the other half of each clock cycle, the 6502 CPU and the rest of the 
Apple's computing circuitry couldn't care less what the main RAM memory was 
up to. 
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So, an elaborate hardware circuit called a multiplexer was set up that gives 
memory access to the Apple's computing circuitry for one half the time and gives 
the Apple’s video-display circuitry memory access for the other half. Each is 
happy with its half of the access, and each piece of circuitry gets its access each 
and every microsecond, 

The result is glitch-free and flicker-free video that is totally independent of any 
computing activity. Most importantly, this is done using the main memory rather 
than a separate video display memory. This means that no time or effort is 
needed to get between a result and putting that result on the screen, No wait 
for video memory access is ever needed. Nor is any time ever taken away from 
the critical video display waveforms. The operation is fully transparent and 
totally invisible. 

Both the thinking and the design that went into the Apple’s video timing 
circuitry was brilliant; it is a totally independent video that is immediately acces- 
sible to all. 

But, they overdid it 

The video display timing is completely independent from the computing 
ti although both are derived from common signals. This means that there 
is no immediate way for the computing circuitry to tell where the video-display 
circuitry happens to be in its timing cycle. 

Field sync gets around this total independence by taking a sample waveform 
from the video display timing and routing it back into a location where you can 
test it with software. We will use part of the cassette read Circuitry as an input 
to feed back this timing signal for us. 

Let's take a closer look at the Apple's video timing and see if we can't find. 
a good waveform to give us field sync. 





Timing waveforms 


A simplified block diagram of the Apple's timing chain is shown in Fig. 4-1. 
There are three main parts to this chain. These are the video rate timing, the 
horizontal rate timing, and the vertical or field rate timing. 

The video-rate timing is the fastest. It starts with a 14.318-megahertz crystal 
oscillator that is the master timing reference for everything in your Apple. This 
master reference is divided by four to get the standard color subcarrier frequen- 
Cy of 3.579 megahertz. The master reference is further divided by 3-1/2 to get 
a CPU clock frequency of 1.023 megahertz. 

This CPU clock frequency also sets one horizontal character time on the 
screen. The horizontal character time is equal to seven video dots. In HIRES, 
these seven dots equal the least significant seven bits in the data word, arranged 
backwards. In standard text, these seven dots consist of two blank undots and 
five horizontal dots from the output of a dot matrix character generator. The 
character generator receives the bits in the data word and then converts them 
to the proper dot patterns for you. 

Either way, seven dots go on the screen in one CPU clock cycle. These seven 
dots equal three and one-half color clock cycles of 3.58 megahertz each. The 
color of the dot will be decided by the position or the time delay of the dot with 
respect to the phase of the color-reference signal. 

The video rate timing does several other things for us. The two clock phases 
needed by the CPU are split out with this timing. The video timing automatically 
gets the seven dots lined up in the right place in the right time for us. And it 
automatically takes care of the multiplexing needed so that the memory can be 
shared between the display and the CPU. This memory multiplexing is more 
complicated than it would seem at first since the memory chips used make each 
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MASTER CRYSTAL 
14318 MHz 





DOT RATE = 7.158 MHz 


VIDEO 
TIMING 
COLORRATE - 3579 MHz 
CHARACTER RATE _ 
AND GPU СГОСК = 1023 MHz 
HORIZONTAL 
TIMING 
HLINE RATE = 15698 Hz 
VERTICAL 
TIMING 





V FIELD RATE = 59.92 Hz 
Fig. 4-1, Details of Apple's timing chain. 


RAM address pin do double duty, Thus, the multiplexer has to go through four 
steps each clock cycle and not just two. 

The CPU clock frequency of 1.023 megahertz is the lowest frequency needed 
by the computing side of the Apple. All of the rest of the timing chain is mainly 
involved in video display timing. Outside of their sharing the same high-frequen- 
cy timing, the computing side and the display side of the Apple are more or less 
independent. 

The horizontal rate timing sets the line length and the horizontal sync rate for 
us. There are 65 possible character positions in a horizontal line. Of these, 40 
are “live” video slots and 25 are “blank” video slots. A live video slot can hold 
seven HIRES dots, a horizontal portion of a 5 х 7 dot matrix character, or a 
color pattern needed as part of a LORES color block. 

Fig. 4-2 shows us the waveform of a single horizontal line. We start with the 
blank character positions. Into these blank character positions, we put a “blacker 


ONE H LINE: 
т 65-17 CPU GLOCKS >| 
[t eo ceu сьоскв 

















— waite 







COLOR LIVE VIDEO, SYNC 
BURST 40 CHARACTERS 
OR 280 DOTS: 






Fig. 4-2. Horizontal rate ti 





display is black or off screen except for live video time. - 
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than black” horizontal sync pulse, followed by a reference burst of a number 
of 3.58-megahertz color-reference cycles. The exact number and position of 
these reference cycles depend on the version of your Apple. Some older Apples 
would not give you color on certain video recorders or on a few oddball brands 
of premium tv sets. The Revision 7 upgrade seems to have fixed this. 

After the horizontal sync pulse and the color burst, we have some more blank 
character locations. These are followed by the 40 live characters per line. 

There is one tiny but crucial detail added in the horizontal timing. The line is 
an odd number of CPU clock cycles in length. Each clock cycle equals 3.5 color 
cycles, which means that when you get to the start of the next line, the color 
reference will be half a cycle off. To get around this, the video timing is delayed 
by half a color clock cycle once each horizontal line. Thus, every sixty-fifth CPU 
clock cycle will be wider by half a color cycle, or around 140 nanoseconds 
wider than usual. 

This handles a key difference between commercial color-tv broadcasts and 
Apple signals nicely. In commercial color tv, you want the color subcarrier to 
cancel each successive horizontal line so that the subcarrier doesn't interfere 
with the luminance video. In the Apple, though, the subcarrier is the video, so 
you want its phase to be the same on each line. If you didn’t do this, a green 
dot on one line would be a violet one immediately below, and 50 оп. 

Atany rate, our horizontal line consists of 25 blank locations followed by 40 
live locations. One of these blank locations is slightly wider than the others 10 
keep the colors in step. Our horizontal sync frequency ends up at 15,698 hertz. 
This compares with the 15,735 hertz of a color commercial tv broadcast or the 
15,750 hertz used for black and white commercial tv broadcasts. 

The horizontal-rate timing also is used to refresh the dynamic RAMs. The 
timing is arranged to exercise the RAMs in such a way that they continue to hold 
valid data for us. This refresh is invisible and "free" since it automatically takes 
place as part of the normal display timing. 

The vertical-rate timing takes the horizontal timing and divides it down by a 
factor of 262, giving us the vertical waveforms shown in Fig. 4-3. There are 192 
live lines and 70 blank lines. The 192 live lines are sequentially scanned in 
HIRES. In LORES, the 192 lines are clustered into 48 groups of 4 lines each, one 
for each LORES block on the screen. In TEXT, the 192 lines are arranged into 
24 groups of 8 lines each, one for each of the possible vertical dot positions 
needed in a 5 х 7 plus blank dot matrix character. 

A vertical sync pulse is provided in the middle of the vertical blanking time. 
This vertical sync pulse is much wider than a horizontal sync pulse. This lets the 
tv separate its vertical sync locking command from its horizontal sync locking 


commands. 
ONE Y FIELD: 
e 282 н Lines: 
ОН LINES — e 192 Н LINES —— | 











— wie 


V SYNC H SYNC LIVE VIDEO. 
PULSE PULSES 192 H LINES 


Fig. 4-3. Vertical-rate timing waveforms. Any mapping or soft switching done during 
blanking or retrace will be invisible. 
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Since there are 65 CPU clock cycles per line and 262 lines total, there are 
apparently 65 * 262 = 17,030 clock cycles per field. The field frequency is 
59.92 hertz. This compares with the 60 hertz of a black and white commercial 
broadcast or the 59.94-hertz vertical rate of a color broadcast. 

Let's sum up some of these magic numbers . . . 


APPLE SYSTEM CONSTANTS 





The CPU clock frequency is 1.023 

megahertz and has a time width of 
0.978 microsecond. Every sixty-fifth 
clock pulse is slightly longer, 


A horizontal line takes 65 CPU clock 
cycles and consists of 25 blank and 
40 live cells. Each cell holds seven 
HIRES dots or one row of dots from a 


dot matrix character. 

Horizontal frequency is 15,698 hertz. 
A vertical field takes 262 horizontal 
lines and consists of 70 blank and 
192 live scans. Live scans are used by 
eights for text, by fours for LORES, 
and by ones for HIRES. 

Field frequency is 59.92 hertz. 


There are 17,030 CPU cycles per 
field. 





The timing waveform we want for field sync will have a rising edge at the 
beginning of the vertical blanking time and a falling edge at the start of the next 
field. If we look at the timing waveforms immediately off the timing chain, we 
see that this waveform is not available. Waveform V5 could be used, but it is 
only six horizontal lines wide, and, also, it is backwards from what we really 
want. 

Instead, there is a vertical blanking waveform derived by an AND gate in 811. 
The magic signal outputs on pin 8 of B11. (See the Apple board parts locations 
sidebar at the end of Enhancement 2 for details on the Apple's parts locations.) 
We've shown this waveform in Fig. 4-4. 

This particular integrated circuit is pretty much buried under the keyboard. 
Check the schematic, though, and we find its output goes to pin 4 of C14. This 
point is much easier to reach. 


GOÈS ТОА "АТ. GOES TOA“O" AT 
BOTTOM OF SCREEN TOPOF SCREEN 


BLANK AND LIVE ViDEO 
RETRACE 


Fig. 4-4. Vertical blanking waveform used for field syne appears on ріп 4 of C14, 
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Fig. 4-5 shows us the “schematic” of the field sync modification. We Connect 
the vertical blanking waveform to a point in the cassette receiver circuitry that 
sometimes sees use as a “phantom” SW3 input. Electrically, this means that we 
jumper pin 4 on C14 to pin 4 on Н14. 


Fig. 4-5. "Schematic" of the field sync VBNK 
modification. One wire does it. cu ata 


Our vertical blanking waveform is low for the 192 live scan lines and high for 
the 70 blank scan lines used for vertical retrace. If we can find the leading edge 
of this waveform with some simple software, we will have the entire blanking 
time to do things to the screen that will not show up till the next field. Also, if 
we can find the trailing edge, we can find out exactly when the next field will 
begin. 

Many of the uses of field sync are just to simply flip a soft switch or two at 
any old time during the vertical blanking interval. Other uses may want to use 
every available microsecond of the vertical blanking time to remap an animated 
sequence. Yet others will need to find the exact start of a field for mixed field 
displays, or for use with either a precision light pen or a touch screen. 


Building it 

The field sync modification consists of a pair of sockets with a jumper wire. 
between them. The mod plugs into the Apple main board. You can easily 
remove the modification later if the unit must be sent in for warranty repairs or 
whatever. 

The modification also has to be removed if you use the cassette playback 
Circuitry or if you use an external game paddle add-on that needs a “ийн” 


push-button input SW3. 
These are the parts you will need , . . 










PARTS LIST FOR 
FIELD SYNC MODIFICATION 







1 — 16-contact quality 
DIP socket, 
machined-pin style. 

T — 14-сотас! quality 
DIP socket, 
machined-pin style. 

1 — piece of No. 24 solid 
wire, insulated, 
7-1/2 inches long. 

1 — short piece of 

electronic solder, 
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And, here are the tools you will need 


TOOLS NEEDED TO MAKE THE 
FIELD SYNC MODIFICATION 


() Needle nose pliers 
() Wire stripper 
( ) Small soldering iron, 35 watt 


(3 IC puller (optional) 


( ) Any old 14- or 16-pin 
integrated circuit 


( ) Small vise or clamp 





Fig. 4-6 gives us the complete construction details. Be absolutely sure to use 
high-quality machined-pin style DIP sockets here, since these are the only kind 
that can easily and safely be plugged into another DIP socket. 

The “dummy” integrated circuit you plugged into the socket helps prevent the 
plastic from melting and keeps the pins aligned but you still have to be careful 
When soldering to these sockets, be sure to prevent any shorts between adjacent 
pins 3 and 5, and be careful not to heat soften and distort either socket. 

A pictorial of the field sync modification is shown in Fig. 4-7. If you 
decide to make your sync mod more or less permanent, you may want 
to tack the wire to the board with hot glue, silicon rubber, or some other 
“semi-permanent” gunk. Be careful not to get any glop on the socket pins. 

Should you ever want to remove your field sync modification, just reverse the 
process that is shown. While this modification does, in fact, void your Apple 
warranty, if you are very careful not to bend any pins or get any ICs mixed up, 
you should be able to remove any signs that the modification was ever 
in use. 


SUPPORT SOFTWARE 


Interpreted Applesoft is far too clumsy and way too slow to directly use field 
sync. You'll find field sync is best handled by short and fast machine-lan- 
guage subroutines. These subroutines can be called from any language you 
like. 

Program 4-1 gives us six simple field sync utility subs, while Program 4-2 is 
an Applesoft routine that will test your field-switch modification for you and give 
you an alternating text and HIRES display. 

The field-switch modification routes a copy of the vertical blanking waveform 
of Fig. 4-4 into the cassette circuitry at "SW3." SW3 is software tested in 
location hex $С060. When you are in the /ive portion of the scan, a zeroor low 
level gets routed to the most significant bit of 5С060, and a test of this location 
will show a positive number іп 2s complement signed binary. When you are 
in the Фалк portion of the scan, a one or high level gets routed to the most 
significant bit of 5С060, and a test of this location will show a negative number 
here, again іп 2's complement signed binary. 
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INSTRUCTIONS FOR BUILDING 
FIELD SYNC MODIFICATION 


1. Cut a piece of insulated Мо. 24 solid wire to a length of 7/2 
inches. Then strip % inch insulation off each end. 


Form a tight loop in each end as shown. 


2. Take a 16-pin machined-contact DIP socket and identify pin 
No. 4 by inking the plastic. Plug any old nonvaluable in- 
tegrated circuit you have on hand into this socket. This will 
keep the pins aligned should the plastic soften. Secure this 
socket in a vise so you can work with it. 


Note that this MUST be the type of premium socket that has 
small machined-pin contacts that are safe to plug into another 
Socket. 


3. Solder one end of the 7% псп wire to pin No. 4 of the 16-ріп 
DIP socket EXACTLY as shown. Be careful not to melt the 
plastic. 


Be sure that no solder gets on the part of the pin that must fit 
into socket H14 on the Apples main board and be sure that 
there is no short to adjacent pins 3 and 5. 


4. Take the 14-pin machined-contact DIP socket and identify 
pin No. 4 by inking the plastic. Move the nonvaluable in- 
tegrated circuit into this socket. 


Secure this socket in a vise just like you did the earlier one. 


5. Solder the remaining end of the 772 -іпсћ wire to pin No. 4 of 


the 14-pin DIP socket EXACTLY as shown. 


Again, be careful not to melt plastic, get solder on the pin, or 


short adjacent pins. 


6. Arrange the field sync modification as shown. Note that the 


wire goes past pin No. 1 on the 16-pin DIP socket and past pin 
No. 7 on the 14-pin DIP socket. 


7. If you want to, add a dab of silicon rubber, epoxy, or other 


glop to the wire where it leaves each socket body. This will act 
as a strain relief and keep the wire from breaking. 


Remove the integrated circuit to complete your field sync 
modification. Put this IC away and out of sight. Refer to text for 
installation and checkout. 








Fig.4-6. How to build the field sync modification. 
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Here is how you install your field sync modification. 


INSTALLING YOUR 
FIELD SYNC MODIFICATION 


‚ Turn off the Apple and unplug 
both ends of the line cord. 


. Verify that no other use is being 
made of the cassette read circuitry, 
such as a “fourth” push button 
SW3 add-on. 

‚ Remove integrated circuit C14, a 


741532, using an IC puller if you 
have one. 


. Plug the 14-pin end of your field 
sync mod into C14. Make sure the 
wire is to the right and the notch is 


pointing towards the keyboard. 


. Plug the 741532 into the 14-pin 
socket now at C14. BE SURE 
NOTCH POINTS TO KEYBOARD! 


. Remove integrated circuit H14, а 
7415151, using an IC puller, if you 
have one. 


. Plug the 16-pin DIP end of the 
field sync mod into H14. Be sure 
that the wire goes to the right and 
the notch points towards the 
keyboard. 

. Plug the 7415151 into the 16-pin 


socket now at H14. BE SURE 
NOTCH POINTS TO KEYBOARD! 





A machine-language command called a BIT test will automatically transfer the 
MSB of $С060 into the М flag for you, allowing easy branching. The only 
confusing part is that the blank time gives you a positive voltage and a 1 to the 
game connector which, in turn, is read as a negative number. The /ivescan time 
gives you a zero voltage and a 0 to the game connector which, in turn, is read 
as a positivenumber. This oddball turn of things is caused by the 2’s complement 
signed binary used by the 650255 branch testing. 

Anyway... 


Your field sync is tested at location 
5С060 by the command BIT 
5С060, or “2C 60 CO”. 


This test CLEARS the N flag during 
live scan times and SETS the N flag 
during vertical blanking times. 
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GAME PADDLE 
CONNECTOR 









(D ADAPTER MADE FROM 
PREMIUM 16РЇМ DIP 
SOCKET GOES IN Н14. 


{согон TRIM 
(2) EXISTING 7415151 

PLUGS INTO 

ADAPTER 

(3) JUMPER WIRE 

CONNECTS PIN 4/Ct4 

TO PIN 4/н14 








Fig. 4-7. Pictorial shows field sync ТА 
modification. rat АН 
(OPTIONAL) 


DIP SOCKET GOES 


А 4 IN C14 


Ва | Фехта 741532 
"3-3 REPLUGS INTO 
4 ADAPTER. 


Іп Program 4-1, we will show you six simple ways to use your field sync. 
These are shown as program modules 1 through 6. These short machine-lan- 
guage modules are all separately located on memory page $03. You can easily 
relocate them in any protected place in your machine that you want. 

Examples of protected space in your Apple are the lower part of page 3 (when 
available), any locations set aside below LOMEM in Integer BASIC, any locations 
set aside above HIMEM іп Applesoft, or one of the slots intended for optional 
character set that are used in HRCG. 

For simplicity, we will show all the examples starting at separate locations on 
page $03. You can relocate these modules anywhere that they won't get plowed 
by something else. 

Our first subroutine is the simplest, being all of six bytes long. It is called 
CRUDE and is just that. We enter this subroutine whenever we want to find the 
vertical blankiag time. If we are in the vertical blanking time already, the BIT test 
will immediately give us a set N flag, and the BPL branch test will immediately 
fail, gi us a fast return. If we are in the live scan time, the BIT test will clear 
the N flag, and the branch will then try again. We keep trying, once each seven 
CPU cycles, till we finally reach the blanking time. Then we exit. 

With this sub, you can always be sure you will return sometime during the 
vertical blanking interval. But, notice that you must not try recalling CRUDE 
more than once рег field. If you have a fast machine-language program, calling 
CRUDE could return several times in the same field and really foul things up. 

The big disadvantage of CRUDE is that you never know exactly how much 
time you have available before the next scan begins. Three times out of four, 
you will have the full blanking time. But every now and then, you will catch the 
blanking at the last possible instant. This only leaves you with a dozen or so 
useful microseconds before the next live scan starts. 

For instance, say you happen to sample on the very last CPU clock cycle of 
the blank portion of the field. Two more CPU clock cycles will be taken up by 
the branch test, which fails, and six more CPU clock cycles will be needed for 
the RTS. This actually puts you into the first live scan line by 7 CPU clock cycles. 
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Го ЕЕ 
РВОСВАМ 4-1 е 
FIELD SYNC UTILITY SUBS B 
ы 
н 
LANGUAGE: APPLE ASSEMBLY NEEDS: FIELD SYNC MOD 
ГРЕОТА 
Sp % * 
DN d FIELD SYNC $ 
7: * UTILITY 5088 * Ї 
eT ut. ($300.392) ж 
DP 3. 
10; % VERSION 1.0 * i 
илз ж ( 7-15-81) * f 
Е * 
13;  * COPYRIGHT 1981 *, 
14 ;  * BY DON LANCASTER * 
15;  * AND SYNERGETICS % 
X5 m JM ы; 
17; % ALL COMMERCIAL * 
18 :  * RIGHTS RESERVED * 
do а = 
20: exe E ru eo 
22 ; THESE SIX MACHINE LANGUAGE B 
23; MODULES ACCESS THE FIELD SYNC 
24 ; MODIFICATION DESCRIBED IN 
25 ; ENHANCEMENT 44 OF ENHANCING 
26 ; YOUR APPLE, VOLUME І. В 
28 ; MODULES MAY ВЕ RELOCATED IN ! 
29; АМҮ PROTECTED SPACE. "a 





31 DELAY EQU ЅЕСАВ 
32 GRAPHIC EQU 5С050 - 
33 KEYBD EQU 5С000 
34 SYNC EQU 5С060 
35 TEXT EQU 8с051 


MONITOR DELAY SUB 
GRAPHICS SCREEN SWITCH 
KEY PRESS CHECK 
VBLANK VIA "SW3" 

TEXT SCREEN SWITCH 
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! 
PROGRAM 4-1, CONT'D... | 

| 

0300: 38 ; MODULE #1 -- "CRUDE" -- | 

0300: THIS MODULE RETURNS SOMETIME DURING 

0300: THE VERTICAL BLANKING INTERVAL. 

0300: 43: ТО USE, JSR $0300 FROM MACHINE LANGUAGE 

0300: 45: DO NOT USE MORE THAN ONCE PER FIELD! 

0300: 47 THIS MODULE MAY BE USED EVERY FIELD. 

0300: 48 IT WILL HANG IF FS MOD IS ABSENT. 1 
| 
1 
1 

0300:2С 60 CO 50 CRUDE ВІТ SYNC + LOOK FOR BLANKING | 

0303:10 ЕВ 51 BPL CRUDE ; AND REPEAT TILL FOUND 


0305:60 RTS THEN EXIT 
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0310: 


0310: 


0310: 
0310: 


0310: 


0310: 
0310: 


0310:2C 60 СО 
0313:10 ЕВ 
С 60 СО 
130 ЕВ 
031A:60 





PROGRAM 4-1, CONT'D... 


55 


57 


59 
60 


62 


64 
65 


67 
68 
69 
70 
71 


і MODULE #2 -- 


ORG 


CRUDE+$10 


"FEDGE" -- 


i THIS MODULE RETURNS AT START 


: ОР NEW FIELD WITH SLIGHT JITTER. 


1: ТО USE, JSR $0310 FROM MACHINE LANGUAGE 


2 THIS MODULE MAY ВЕ 
B IT WILL EANG IF FS 


FEDGE 


BLANK 


BIT 
BPL 
BIT 
BMI 
RTS 


SYNC 
FEDGE 
SYNC 
BLANK 


USED EVERY FIELD. 
MOD IS ABSENT. 





; 


LOOK FOR LIVE SCAN 

AND RETRY TILL BLANK 
LOOK FOR BLANKING 

AND RETRY TILL LIVE 


THEN EXIT 


1! 

















Field Sync 103 

















PROGRAM 4-1, CONT'D... 


0320: 74 ORG CRUDE+$20 

0320: 76 ; MODULE 43 -- "BEDGE" 

0320: 78 ; THIS MODULE RETURNS AT START 

0320: 79: ОҒ VBLANK TIME WITH SLIGHT JITTER. 
0320: 81: ТО USE, JSR $0320 FROM MACHINE LANGUAGE 
0320: 83 THIS MODULE MAY BE USED EVERY FIELD. 


0320: 84 ; IT WILL HANG IF FS MOD IS ABSENT. 


0320:2C 60 CO 86 BEDGE BIT SYNC 
0323:30 FB 87 BMI BEDGE 


LOOK FOR BLANK 

AND REPEAT TILL LIVE 
LOOK FOR LIVE SCAN 

AND REPEAT TILL BLANK 
THEN EXIT 
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PROGRAM 4-1, CONT'D... 


0330: 


0330: 


0330: 


0330: 
0330: 


0330: 
0330: 


0330: 
0330: 


0330: 


0330:20 
0333:8D 
0336:20 
0339:8D 
оззс:2с 
033F:10 
0341:60 





03 
со 
03 
co 
co 


93 


95 


97 


98 
99 


101 
102 


104 
105 


107 


109 
110 
111 
112 
113 
114 
115 








ORG CRUDE+$30 


7 MODULE #4 





"ALTFLD" 





THIS MODULE ALTERNATES BETWEEN 


? ТЕХТ AND GRAPHICS FIELDS. ІТ 
? EXITS ON ANY KEY PRESSED. 


; TO USE, JSR $0330 FROM MACHINE LANGUAGE 
: OR CALL 816 FROM EITHER BASIC 


THIS MODULE DISPLAYS CONTINUOUSLY 
TILL ANY KEY IS PRESSED. 


; ІТ WILL HANG IF FS MOD IS ABSENT. 


ALTFLD JSR 
STA 
JSR 
STA 
BIT 
BPL 
RTS 





FEDGE 
GRAPHIC 
FEDGE 
TEXT 
KEYBD 
ALTFLD 


FIND FIELD START 
SWITCH GRAPHICS ON 
FIND FIELD START 
SWITCH TEXT ON 

HAS KEY BEEN PRESSED? 
CONTINUE IF NO KEY 
EXIT ON KEYDOWN 
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PROGRAM 4-1, CONT'D... 


0350: 





0350:2C 
0353:10 
0355:2C 
0358:30 
035A:EA 
035B:10 
035D:A9 
035Е:20 
0362:А9 
0364:20 
0367:A9 
0369:20 
озес:2с 
036Е:10 
0371:60 


60 
ЕВ 
60 
ЕВ 


00 
3в 
АВ 
34 
АВ 
01 
АВ 
60 
ЕС 


со 


co 


ЕС 


үс 


ЕС 
со 


118 


120 


122 
123 
124 


126 
127 


129 


131 
132 


134 
135 


137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 


ORG 


CRUDE+$50 


MODULE #5 -- "ЕХАСТЕ" -- 


THIS MODULE EXITS EXACTLY SEVEN 
MICROSECONDS INTO THE START OF A 
NEW FIELD WITH ZERO JITTER. 


UP TO SEVEN FIELDS MAY BE 
NEEDED TO ACQUIRE EXACT LOCK. 


TO USE, JSR $0340 FROM MACHINE LANGUAGE 


ONCE LOCKED, MAIN PROGRAM MUST 
CONTINUINE LOCK TILL DONE. 


THIS MODULE MAY NOT BE USED EACH FIELD. 
IT WILL HANG IF FS MOD IS ABSENT. 


EXACTF BIT 


BPL 


BLENK BIT 


BMI 
NOP 
BPL 


STALL LDA 


JSR 
LDA 
JSR 
LDA 
458 
вїт 
ВРЬ 
RTS 


SYNC ; FIND BLANKING TIME 
EXACTF 1 
SYNC ; FIND FIELD START 
BLENK ; WITH JITTER 

; STALL FOR 2 CYCLES 
STALL ; STALL FOR 3 CYCLES 
+538 : DELAY FOR 17029 
DELAY ; CLOCK CYCLES TOTAL 
#534 : USING THE MONITOR 
DELAY ; DELAY ROUTINE AND 
%501 : THIS LOOP TIMING. 
DELAY i 
SYNC : HAVE WE BACKED TO START? 
STALL ; NO, GO BACK ONE MORE 


EXIT ON EXACT LOCK 
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PROGRAM 4-1, CONT'D... 


0380: 


0380: 


0380: 
0380: 
0380: 


0380: 
0380: 


0380: 


0380: 
0380: 


0380: 
0380: 


0380:2C 
0383:30 
0385:2C 








о 
0392:л9 
0394:20 
0397:39 





154 


156 


158 
159 
160 


162 
163 


165 


167 
168 


170 
171 


173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 


ЕХАСТВ BIT SYNC 


BLUNK BIT SYNC 


STAUL LDA #938 


ORG CRUDE+$80 


MODULE #6 -- "EXACTB" -- 


THIS MODULE EXITS EXACTLY SEVEN 
MICROSECONDS INTO THE BLANKING OF A 
NEW FIELD WITH ZERO JITTER. 


UP TO SEVEN FIELDS MAY BE 
NEEDED TO ACQUIRE EXACT LOCK. 


TO USE, JSR $0370 РВОМ MACHINE LANGUAGE 


ONCE LOCKED, MAIN PROGRAM MUST 
CONTINUINE LOCK TILL DONE. 


THIS MODULE MAY NOT BE USED EACH FIELD. 
IT WILL HANG IF FS MOD IS ABSENT. 


FIND LIVE SCAN TIME 
ВМТ ЕХАСТВ 
FIND BLANKING START 


BPL BLUNK WITH JITTER 
NOP STALL FOR 2 CYCLES 
BMI STAUL STALL FOR 3 CYCLES 


DELAY FOR 17029 





JSR DELAY CLOCK CYCLES TOTAL 
LDA #934 USING THE MONITOR 

JSR DELAY DELAY ROUTINE AND 

LDA 4901 THIS LOOP TIMING. 

JSR DELAY 

BIT SYNC HAVE WE BACKED TO START? 


BPL STAUL 7 NO, GO BACK ONE MORE 
EXIT ON EXACT LOCK 


RTS 





*** SUCCESSFUL ASSEMBLY: NO ERRORS 
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But, each live scan line starts off with its 25 blank CFU clock сусе» used fur 
horizontal retrace, syno, and the color burst. The net time we have leit is only 
25—7 = 18 CPU clock cycles. 

Note that a clock cycle is slightly less than a microsecond. We could say 
“microsecond” when we really meant "CPU clock суде” and wouldn't really 
be off that much. 

Atany rate, 18 CPU clock cycles is more than enough time to flip a few screen 
switches, but is far too short to do the extensive graphics remapping needed for 
animations or game graphics. 

You use the CRUDE module as you would any old subroutine. Just do а JSR 
$0300 from a machine-language program. 

Note that most of these code modules will hang up on an unmodified Apple 
that does not have field sync installed. High-level user software should have 
some extra test included to make sure the field sync mod is in place before any 
of these modules are called. 

Module number 2 is named FEDGE and finds the start of a new field for us. 
What we do is wait till we are sure we are on the blanking part of the scan and, 
then, look for the instant that the live scan starts. This software tool is called an 
edge detector. lí you happen to enter during the live scan time, the first ВІТ test 
spins its wheels till you reach the blanking time. Timing then drops through to 
the second BIT test which also spins its wheels till the start of the live scan time 
that tells us a new field has begun. 

Оп the other hand, if you happen to enter during the blanking time, the first 
test fails immediately, and you drop through to the second BIT test that loops 
till the start of the next field. 

The advantage of this FEDGE module is that it will always exit near the 
beginning of the live scan time. Since this module is edge sensitive, it always 
waits till the start of a new field before exiting. 

Like CRUDE, module FEDGE can be used over and over again, once per field, 
as needed. After you exit FEDGE, you can go on and do anything you want with 
the machine. 

There are several disadvantages to using FEDGE. The first disadvantage is that 
this routine will hang up оп an unmodified Apple, since SW3 has to change to 
allow an exit. The second disadvantage is that there can be a jitter of up to 7 
CPU clock cycles on the exit. This jitter is trivial compared to the jitter of 
CRUDE, but it is still not acceptable for precision field sync uses. Another 
disadvantage of FEDGE is that almost an entire field can be spent stuck in the 
subroutine if you aren't careful. This means you should adjust the rest of your 
program so that its length doesn’t compound the time that it has to waste in the 
subroutine. 

We can easily “inside out” our FEDGE sub to give us a BEDGE subroutine. 
This one is shown as module number 3 and exits on the start of blanking on the 
first available field. If you happen to enter during the blanking time, the first BIT 
test keeps retrying till the live scan time. Then, the second BIT test keeps retrying 

лэ till you reach the start of the blanking time. Then you exit. You exit on the start 
of blanking plus one to seven CPU clock cycles. This leaves you with 70 full lines 
or some 4350 CPU cycles to do good stuff with before the start of the next field. 
This is more than enough time for simple animation where only a portion of the 
screen is to be remapped. 

The BEDGE subroutine is best used when a medium amount of remapping is 
needed, while the FEDGE subroutine is best for flipping a single soft switch or 
two, or else, when used for remapping so extensive that you are using two HIRES 
pages and taking the entire field or more to update. Otherwise, the two subs 
have the same advantages and disadvantages. 
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Our fourth module is called ALTFLD and will automatically switch you from 
text on one field to graphics on the next. The module works by calling FEDGE, 
switching to graphics, calling FEDGE again, and, then, switching to text. It then 
looks for any key pressed and loops if there is no response. The display will mix 
text and HIRES for you as long as you like. 

You can reach ALTFLD by a JSR to $0330 from a machine-language program. 
Unlike our earlier modules, it is also feasible to directly reach ALTFLD from 
either BASIC. CALL 816 does it. We will see an example of this in Program 4-2. 

This is a very simple field alternator. We may look at fancier field alternators 
їп a future enhancement. We've included a simple field alternator here so that 
we have a way to test your field sync mod, and so that you can get started very 
simply and quickly on your own. 

Module number 5 is the big surprise since many people would swear it is 
impossible to measure to an exact clock cycle with software which takes 7 CPU 
clock cycles to read and test at a port. These same disbelievers have gone out 
of their way to build all sorts of totally unneeded and ridiculous hardware so as 
to use things like precision light pens, touch screens, and so оп. As we will see, 
it is trivially easy to quickly find any exact screen location using nothing but a 
few bytes of ordinary machine-language software. 

We will look at two methods of doing an exact field lock. A simple software- 
only method appears here but a much faster and more flexible method that takes 
extra hardware will be shown you in Enhancement 13 of Volume 2. 

Module EXACTF will find the exact start of a field for you, jitter free. To see 
how it works, we have to carefully look at machine-language instruction timing. 
The following procedure shows us the key secret. 

The following steps illustrate how to do an EXACT screen lock using software. 
kemember that the last part of the FEDGE program looks like this . . . . 





BLANK Bir SYNC. 
эм BLANK 
L3 











What this says is, "Read the port named SYNC. If the port is high, go and read 
the port again. If the port is low, exit immediately." This part of FEDGE is used 
to find the start of the new field for us. 

But, the commands BIT and BMI take time. How much time? The BIT test 
takes 4 clock cycles and the BMI branch takes 3 clock cycles every time it 
repeats. This is a total of 7 clock cycles per try, or roughly 7 microseconds. Thus, 
it would seem that you can only read a port once every 7 clock cycles. 

So, it would appear that there is an “inherent” 7-microsecond jitter in reading 
an outside random event that is routed to a port. And, indeed, there is if you 
read the port only once. 

The preceding simple program will make its “last” measurement anywhere 
between one and seven microseconds after the port input goes low. Let's sup- 
pose that, this particular time around, we just happen to make our "last" meas- 
urement at 3 clock cycles into the start of the new field. 

Like зо... 


pea SAY WE HIT HERE 
‘ON FIRST TRY 
WAVEFORM 





ЕЮ: 
сэв сүсие 
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There are exactly 17,030 clock cycles іп ал entire field. Let's do a time delay 
of precisely 17,029 clock cycles and, then, make a new measurement. We are 
now only ¿wo microseconds into the next field, since going forward for 17,029 
clock cycles is exactly the same as backing up one clock cycle on the next field. 

This new measurement turns out this way 


NEXT FIELD 
BLANKING WE LAND HERE 
WAVEFORM 


ГІЗГІ 
E 
cpu CYCLES 





Now, delay another 17,029 clock cycles and we end up 1 microsecond into 
the next field, since we backed up one more clock cycle. 


AND HERE ON 
BLANKING. THE NEXT FIELD 
WAVEFORM 





TERE 
cru crcues 


And, let's do it one final time. Only now, we “miss” the low part of the 
blanking waveform. But we see that we are EXACTLY at the start of the new field 
with zero jitter. 

So, we exit. 

We have done ап exact lock to the blanking waveform . . . . 


тне TIME, we HIT 
THE EXACT START 
AND EXIT JITTER 
BLANKING FREE 
WAVEFORMS 





Epp 
SH a ds 
cpu cvcues. 


The number of fields till lock can be any amount from one to seven, but when 
you finally exit the final measurement, you have an EXACT lock on the last field 
that came up. 

The logic behind a software EXACT lock says . . . 


Find the start of a new field with 
the usual jitter. = 
Then, back up one clock cycle per 


field till you miss the start of the 
field. 


Then exit. 





Here's а flowchart that says the same thing . . . . 
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FIND FIELD 
EDGE WITH 
USUAL JITTER, 


A BIT test of an absolute location takes 4 CPU clock cycles. A BPL or BNE 
branch needs 3 CPU clock cycles if taken. Thus, the fastest that we can possibly 
retest any absolute memory location seems to be once each 7 CPU clock cycles, 
or roughly once each 7 microseconds. Since you can enter these field sync 
modules at random, this implies that there is an inherent 7-microsecond jitter 
in any software measurement. And, 7 microseconds ог 7 CPU clock cycles is 
7 character slots across the screen. So, it looks like we are stuck with a 7- 
microsecond jitter, like it or not. 

Taint so. 

Now, follow the bouncing ball. One entire field takes 17,030 CPU clock 
cycles, right? So, suppose we do a BIT test and, then, delay exactly 17,029 CPU 
clock cycles, or precisely and exactly 1 clock cycle /ess than one whole field. 
Regardless of where our field-start BIT test ends up, the new one takes place 
exactly 1 CPU clock earlier in the next field. We have backed up precisely 1 
CPU cycle. 

So, all you do is find the rough start of the next field using a code like FEDGE 
and, then, keep backing up one cycle per field till you miss the start, At that 
Point, you exit. Your exit will take 2 CPU cycles for the test failed and 6 CPU 
cycles for the RTS, and you start at minus 1 CPU cycle from the field start. This. 
exits you exactly 7 CPU cycles into the start of the new field. Remember that 
this leaves you with 25--7- 18 CPU cycles in the horizontal blanking time to 
play with. This is more than enough time to set up a split screen, a video wipe, 
or the timing for a light-pen measurement. 

And, it is exact. There is zero jitter. We repeat. This will exactly find the start. 
of a field for you. 

There is a delay program called WAIT that is built into. your Apple monitor 
starting at БЕСАВ. We call this delay subroutine three times in a row to help us 
hit the exact timing that we need 10 delay 17,029 CPU clock cycles. Actually, 

ve pick three magic delay values to total 17,016 CPU clock cycles. The remain- 
ав 13 CPU clock cycles are used up by the three immediate loads, the BIT test, 
and the branch in the loop. 
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What happens is that you find the leading edge of the new field using a 
FEDGE-like code, just like you did before. This gets done with 1 to 7 CPU clock 
cycles of jitter. Then, you back up exactly 1 CPU clock cycle per field till you 
hit the exact field start. 

Then, you exit. 

This is sort of like stopping your car suddenly at an intersection and, then, 
backing up to make sure you really were out of the crosswalk. 

Exact sync does take a while. Up to seven fields may be needed to acquire 
an exact "lock." This will average out to around three fields or so per try, or 
something like one-twentieth of a second. But, this one-twentieth of a second 
is usually invisible since it is tacked onto the end of whatever it was that 
happened before. 

Note that in light-pen uses, we may have to repeat the backing-up dose again 
when we sense the pen input. Thus, an average of a tenth of a second will be 
needed to hit a light-pen position of one of 40 exact character locations in one 
of 192 exact lines. You can thus easily find any one of 7680 screen locations 
in a tenth of a second by using nothing but a short piece of wire and some pure 
software. 

A tenth of a second is slightly slower than some special hardware might need, 
but since EXACTF eliminates almost all the light-pen circuitry and since it is faster 
than most people can react, it is most useful. 

In Enhancement No. 5, we will look at mixed fields, a brand new and most 
exciting use of EXACTF. With mixed fields, you can mix and match text, HIRES, 
and LORES in any combination anywhere on the screen, as well as doing screen 
splits and dynamic video wipes. 

You can also "inside ош” your ЕХАСТЕ to find the exact start of blanking if 
you want to. We have shown this as module 6 and named it EXACTB. This time, 
you exit exactly 7 CPU clocks into the vertical blanking rather than 7 CPU clocks 
into the next field. 

One limit to EXACTF or ЕХАСТВ is that you cannot use either one each and 
every field, like you could the earlier subroutines. The reason for this is that up 
to seven fields may be needed in order to back up to the exact timing exit point 
we are after. This means that you have to keep your exact lock till you are 
finished with it, During the time you keep the lock, each and every CPU clock 
cycle must be exactly accounted for. 

For instance, for light-pen use, after you acquire an exact lock, you have to 
increment software counters for line and position measurement and do whatev- 
er else you need to do to end up with an exact measurement. If you are doing 
a horizontal video split, or other mixed field, your timing must remain controlled 
and constant till you are done. This means that you probably will want to either 
time out your split or else test for a pressed key to exit. Your CPU will be tied 
up till you are done with the display. We will see just how to handle this timing 
situation and how to make room for other program time problems in the next 
enhancement. 

The point is that once you do an exact lock with EXACTF or EXACTB, your 
CPU is 100% committed to the reason why you wanted: to lock until you are 
finished. This is unlike the earlier subroutines that quickly return control back to 
your main programs. 

We will note in passing that you can do an exact lock in a fraction of a field, 
rather than in seven fields, if you are willing to add extra hardware. This greatly 
simplifies program coding. Details on this appear in Enhancement 13 of Volume 
2. 


Let's sum all this up. 
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THE FIELD SYNC MODULES 


CRUDE —Exits sometime during 
the vertical blanking time. It 
will not bomb if the FS mod 
is absent. It may be used 
each field but must not be 
called twice in a field. 


EDGE —Exits on the start of a 
new field with some jitter. It 
will bomb if the FS mod is 
absent. It may be used each 
field. 


BEDGE —Like FEDGE, only exits 
оп start of blanking. 


ALTFLD —Switches between text 
and graphics fields continu- 
ously until any key is 
pressed. Needs FEDGE to. 
run, and will bomb if the FS 
mod is absent. 





EXACTF —Finds the exact start 
of a field with zero jitter. 
May take up to seven fields 
to do a perfect lock. Will 
bomb if FS mod is absent. 
Lock timing must be con- 
tinued by calling program. 


EXACTB —Like ЕХАСТЕ, only 
exits on exact blanking ап. 











To rehash, use CRUDE for simple field switching if you are sure you won't 
be calling it more than once per field. Use FEDGE when you want the start of 
a field with no danger of catching the same field twice. Use BEDCE if you need 
а medium amount of animation per field, 

Use the ALTFLD for simple text and graphics overlays. Use EXACTF when you 
want to find the start of a field exactly for use with a light pen, touch screen, 
horizontal video split, or horizontal video wipe. Or, use ЕХАСТВ to find an exact 
screen location and, then, do lots of setup before the live scan time actually 
starts. 

We will see more examples of how to use your field syne in upcoming 
enhancements. Note that we have kept each sync module separate so you can 
add to them or move them anyway you like. The funny misspellings are done 
50 that each module has its own unique label inside a common assembly- 
language source program. 

While we have shown an RTS, or Return from Subroutine, at the end of each 
module, you are free to move any RTS down and stuff as much other machine- 
language code in the subroutine as you like. 

Program number 4-2 shows us a quick way to test your field sync modifica- 
tion. This Applesoft program loads ALTFLD and FEDGE. It then prints a message 
оп Text | and some artwork on HIRES 1. ALTFLD is then called on to superim- 
pose text and HIRES. The text-over-HIRES display continues till you hit any key. 

Your field sync is working if you get the double text and HIRES image with 
по glitches or noise anywhere on the screen. Some flicker is normal with this 
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PROGRAM 4-2 
FIELD SYNC QUICK TEST 


|| 




















LANGUAGE: APPLESOFT 


10 REM #3 ei Rt 


12 REM 
14 REM FIELD SYNC 
16 REM QUICK TEST 
18 REM 


* 
* 
* 
* 
20 REM * VERSION 1.0 
22 REM * 
24 REM * COPYRIGHT 1981 
26 REM * BY DON LANCASTER 
28 REM * AND SYNERGETICS 
30 REM * 
32 REM * 
34 REM * 
36 REM * 
38 REM * 


ALL COMMERCIAL 
RIGHTS RESERVED 


ORO ORO OE жж 


YOUR GOROE ORO OR 


52 REM FIELD SYNC DESCRIBED 
54 REM IN ENHANCING YOUR 
56 REM APPLE II, VOLUME I 


80 REM NEEDS ALTFLD AND 
82 REM FEDGE FIELD SYNC 
84 REM SUBROUTINES. 


100 PRINT "BLOAD FIELD SYNC UTIL 
ITY SUBS": REM CTRL D 


200 HOME : VTAB 4: REM TEXT 

210 PRINT "YOUR FIELD SYNC": PRINT 
“IS WORKING IF ... 

220 УТАВ 10: НТАВ 14: PRINT "THE 
SE WORDS“: HTAB 14: PRINT " 
ARE IN A BOX" 

230 УТАВ 16: НТАВ 20: PRINT " 
AND THERE ARE NO 

240 НТАВ 20: PRINT " GLITCHES 
ANYWHERE";: HTAB 20: PRINT 
* ОМ THE SCREEN.": REM 




















NEEDS: FIELD SYNC MOD 
FEDGE SUB 
ALTFLD SUB 
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PROGRAM 4-2, CONT'D... 


250 HGR : HCOLOR= 5: РОКЕ - 163 
02,0: REM GRAPHICS 

260 HPLOT 80,64 TO 184,64 TO 184 
,98 TO 80,98 TO 80,64 

270 HPLOT 81,65 TO 185,65 TO 185 
,99 TO 81,99 ТО 81,65 

280 HCOLOR= 1: HPLOT 31,12 ТО 31 
‚81 ТО 75,81 TO 71,76 ТО 75, 
81 ТО 71,86 ТО 71,76 

290 НРЬОТ 29,11 ТО 29,16 ТО 33,1 
1 ТО 33,16: НРЬОТ 73,78: НРЬОТ 
73,82: HPLOT 73,80 

300 HCOLOR= 2: HPLOT 191,81 TO 2 
36,81 TO 236,116 TO 232,112 TO 
240,112 TO 236,116 

310 HPLOT 189,80 TO 197,80 TO 18 
9,82 TO 197,82: HPLOT 236,11 


3: REM Ї 

400 FOR N = 1 ТО 3000: NEXT N: PRINT | 

ЭЭ: REM BELL CTRL С | 

410 ТЕХТ : FOR М = 1 ТО 3000: NEXT Ї 

М: PRINT "";: REM BELL CT | 

RL G | 

500 CALL 816: REM CALL ALTFLD | 

990 РОКЕ - 16368,0: REM RESET | 
KEY STROBE 

995 PRINT : PRINT "RUN MENU": REM Ї 

ЕХЇТ ОМ КР | 

996 REM DELETE 995 IF AUTO MENU | 

IS NOT IN USE Ї 

| 

| 


999 END 
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particular use of field sync. You can minimize this flicker by using black and 
white rather than color displays, or by using darker colors rather than white, or 
by minimizing large blocks of text, or by keeping the total screen information 
and display time at a minimum. Proper setting of contrast and brightness on the 
display will also make a big difference. 

Once again, this apparent flicker applies only to some field alternators. Practi- 
cally all other uses of field sync are glitch and flicker free. 

Note that your field sync must have exclusive use of the cassette read circuitry 
and SW3 when it is in use. We have used the phantom “5/3” input of the 
cassette read circuitry instead of the more obvious game paddle SW2 because 
many word processor programs will use SW2 to route a SHIFT key command 
into their programs, 

You have to break your field sync connection any time you use your cassette 
input. Direct entry of the blanking waveform into the IN jack of the cassette is 
not recommended—first, because capacitor C10 is too small and, more crucial- 
ly, because the long and ёггайс delay in analog amplifier K13 would give 
unpredictable results in precision field sync applications which need an exact 
lock. 

Precision field sync is so important and so exciting that it should be immedi- 
ately added to your Apple and done in a simple, standard, and easy-to-use way. 
Let us know what new uses you find for this exciting new capability @ 





The Apple Assembler source and 
object programs FIELD SYNC 
UTILITY SUBS.SOURCE and FIELD 
SYNC UTILITY SUBS, along with 
the Applesoft program FIELD 


SYNC TESTER are included on (һе 
companion diskette to this volume. 
All three programs are fully copya- 
ble. 












A complete set of all parts needed 
to build one field sync modifica- 

tion is included in the companion 
parts kit to this volume. 
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FUN WITH 
MIXED FIELDS 


Mix TEXT, HIRES, AND LORES 
anywhere on the screen using your 
field sync mod and some simple 
support software. Displays are 
glitch and flicker free and open up 
many exciting new uses. The se- 
cret of the 121 LORES colors is also 
revealed. Or, is it? 


FUN WITH MIXED FIELDS 


How would you like to be able to mix and match text, LORES, and HIRES 
together anywhere you like on your Apple screen? It’s a lot easier than you might 
think. All it takes is some simple support software that we'll look at here. We'll 
use it along with the one-wire field sync mod of Enhancement 4. 

Now you can freely mix text and LORES color, even off of the same display 
page, and anywhere you like on the screen. You can title HIRES displays at the 
top and sides, mix HIRES and LORES together, and label LORES bar graphs. You 
can inset and quickly change normal, inverse, or flashing text anywhere on a 
HIRES or LORES display. 

Think of the possibilities! And, the mix-and-match magic of mixed fields can 
be done much simpler and much faster than can be accomplished by using a 
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„aight HIRES display. Your memory needs also сап be much smaller with 

mixed fields, And, the basic idea behind mixed fields can be easily extended into 

mind-boggling things like video wipes, whole new worlds of animation, external 

video special effects, and true 3-D vibrating mirror displays. | 
What is а mixed field? 


| 
| 
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MIXED FIELD —An Apple video 
display mode that changes 
between text, LORES, and 
HIRES on the Йу, letting you 

mix and match what goes on В 
the screen at any instant. 










The exciting thing about mixed fields is that everything is there at once. Since 
the screen is switched “on the fly,” there is no flicker like you sometimes get 
with alternating field displays. 

As with any Apple feature, mixed fields have some limits and disadvantages. 
The first is that you have to very carefully set up a display file that is part of a 
display program. This display file controls when modes get changed on the 
screen. The display file isn’t nearly as bad as a shape table, but you still must 
be able to use and understand one before you can get mixed fields to work for 
vou. 

The second limiting factor to mixed field displays is that they take up the lion's 

лаге of the CPU time when you are using them. Mixed field displays are better 
suited for titles, transitions, and displaying results than for use where you must 
do a lot of real-time computing. We have built in an automatic display timer and 
an option to exit on any key pressed. These give you the continuity you will need 
10 use mixed fields. You can easily switch between mixed fields and regular И 
displays at any time іп a program. Ї 

You also have the option of using ир to 4300 ог so clock cycles per field for 
things like limited animation, character entry, and so on. The available through- 
put ends up around one quarter of normal with this option. Use of this nondis- 
play time is tricky, since you must either maintain an exact number of clock 
cycles or else resynchronize each field. 

The third limit to mixed fields is that you can get some very awful glitches on 
the screen if you aren't careful. The absolute worst source of the glitches is 
caused by a change Apple made back in Revision 1. This one is easily eliminated 
with the $3.00 Glitch Stomper mod upcoming in Enhancement 6. The remaining 
glitches are easily made invisible once you understand what causes them. You 
сап even make the glitches work for you once you really get to know them. 

All in all, though, these limits to mixed fields are easy to get around if you 
spend the time and trouble to understand what field switching is all about. And, 
the spectacular results certainly make it all worthwhile. 


How mixed fields work 


The following example will show how mixed field displays work. The general 
idea behind mixed fields is to flip soft switches in exactly the same screen 
osition for every successive field. In this example, we do a graph, starting with 
4 one-line text title at the top. Then, we do a single LORES horizontal grey line 
separating title from graph. The graph itself consists of Y-axis text on the left and 








ч i 
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HIRES lines and points on the right. Finally, we do the X-axis stuff in straight text. 
For each and every field, soft switches are flipped in just the right locations to 
make all this happen. 

In order to understand how to do a mixed field display, it is necessary that 
you fully understand the following procedure. 

A mixed field display needs the field sync mod of the previous enhancement 
and an exact locking program called VFFS. Inside VFFS are three sets of files, 
called CONTROL, HPAT, and VPAT. These files are changed to suit your needs. 

For instance, suppose you want to do a fancy graph with a title at the top, 
then a grey bar, then a HIRES graph with ordinary text as the Ү axis, then a 
two-line text X axis below. 

Something like this 


GRAPH TITLE 








Split the display up into horizontal pieces, starting from the top. Each piece 
has to have an identical horizontal pattern on each and every one of its scan 
lines. With VFFS, you are allowed to have four different horizontal patterns. 
These four horizontal patterns can repeat in order as often as you like. 

Our first horizontal pattern is used for the title. It simply switches to text and 
keeps us in text for the eight lines that are needed to put down a row of 
characters . . . . 


GRAPH TITLE 
М ALL TEXT 
Our second horizontal pattern is used for the grey bar. It simply switches us 


to LORES and keeps us in LORES for another 8 lines. We'll use 4 lines for some 
black space under the title, and the second 4 lines for the grey bar. 


BLACK 
`~ 





s 
внесе Е eat tones 








а 
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Your text and LORES сап be off the same display page as long as you use 
multiples of 8 scan lines per mode. 

Our third horizontal pattern is more complicated. It switches to text at the start 
of each horizontal line and then switches to HIRES on the eighth character of 
each and every horizontal scan line. This continues for most of the display, down 
to line number 175. 


EACH SCAN LINE SWITCHES 
FROM HIRES TO TEXT HERE 


EACH SCAN LINE SWITCHES 
y FROM TEXT ТО HIRES HERE 


Our final horizontal pattern goes back to all text, and lasts for the final 16 scan 
lines, going from line 175 to the bottom of the screen at line 191. 


10 20 30 40 56 60 га 
LENSES E 


МЖ. TWO ROWS ОҒ 
ALL TEXT 


VFFS first does an exact lock and, then, repeats its formatted display every 
field. The display ends on a pressed key, a selected timeout, or both. 

This particular example is comparable to VFFS.GRAPH that is used in demon- 
stration Program 5-2. Each new set of file values should be saved under its own 
unique name. 

In the preceding example, any time you read or write to memory location 
$C050, the display will immediately switch to its text mode. Whenever you read 
or write to memory location $C051, the display immediately switches to its 
graphics mode. If you flipped the $C050 switch at the top of the screen and then 
flipped 5С051 after 8 scan lines went by, you would end up with a line of text 
at the top of the screeh and graphics the rest of the way down. 

Why the eighth line? Because there are eight horizontal raster lines needed 
per character, since each character is made up vertically of seven live dots and 
a blank undot. The number of raster lines usually needed equals eight times the 
number of text lines. As long as you stick with multiples of eight raster lines, you 
can even have your LORES and text come off the same display page! 

Other switches will let you flip between HIRES and LORES, between memory 
page 1 and memory page 2, and between full and mixed graphics. And, since 
the programs we will show you can hit many different locations in the |/O space, 
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you can also flip the annunciator soft switches or read push-button inputs. This 
opens the door to special video effects, singling ош one display line for analysis, 
doing animation and wipes, using precision hardware-free light pens, doing 
touch screens, adding grey scale and anti-aliasing, providing sync for 3-D vibrat- 
ing mirror displays, and so on. 

Some very simple field mixing can be done by flipping a soft switch or two 
at any old time during the vertical blanking interval. For fancier field mixes, we 
have to lock to the field start exact/y, using EXACTF ог something similar. An 
exact lock is needed anytime you want to change something in the middle of 
a horizontal scan line. 

To use field sync, you set up a switch-flipping program that takes exactly one 
field to complete. You then find the start of a field with EXACTF and, then, drop 
into this switch-flipping program. The program then keeps changing the display 
back and forth for you, putting what you want exactly where you want it. This 
will continue until either an automatic timeout is completed or until a key is 
optionally pressed. 

You can write lots of very simple mixed field programs. One could give you 
changes at the beginning of any horizontal line. Another could give you changes 
along any horizontal line. Yet another could give you a way to inset text, and 
50 оп. 

Instead of all these relatively simple and specialized programs, we will show 
you one fairly fancy machine-language subroutine called the Video Field For- 
matter Sub, ог VFFS for short. We will start out with a do-nothing VFFS called 
VFFS.EMPTY. You will then customize the files in this VFFS to do whatever you 
like and, then, rename it. Examples that we will see will include VFFS.BOXES, 
VFFS.GRAPH, and so on. 

VFFS.EMPTY appears as Program 5-1 and can be used to flip up to 11 
Switches on each and every one of 192 live scan lines for a total of up to 2112 
display changes per field. 

Probably the best way to understand VFFS is to jump in with both feet and 
use it. An Applesoft demo, called Fun With Field Switches, is shown as Program 
5-2. This demo shows you some mixed field animation, a HIRES plot with text 
vertical titling, a LORES bar graph with text callouts, and a final display that mixes 
three alphabets for you. 

VFFS.EMPTY is а machine-language program that needs a total of around 520 
bytes, including its working files. We have stashed it starting at $8AFF, or 
decimal 35583. You must protect this space from either Applesoft or Integer 
BASIC use. The HIMEM command can do this for you, either early in an 
Applesoft program or before loading an Integer program. | used this space 
because you can optionally load and protect VFFS in the highest optional char- 
acter slot under Apple's HRCG Hi-Res Character Generator. 

You can easily relocate VFFS anywhere you like, but any relocation will 
change all the file locations and design worksheets we are about to look at. 


Working files 


The keys to VFFS lie in three sets of files. The simplest file is a one-byte file 
called CONTROL. CONTROL sets the length of time that the display is active 
and decides whether a keypressed exit is allowed. CONTROL is located at 
58СЕВ (decimal 36091). Figure 5-1 shows us how CONTROL is used. 

The most significant bit of CONTROL is set 10 а оле to activate the key- 
pressed exit, and cleared to a zero to disable the keypressed exit. The next 
most significant bit of CONTROL is set to a one to activate the automatic 
timeout or cleared to zero for an "infinite". display. The remaining six lowest 
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PROGRAM 5-1 


VIDEO FIELD FORMATTER SUB. VFFS. EMPTY 








LANGUAGE: APPLE ASSEMBLY 














NEEDS: FIELD SYNC MOD 


ы 


НІМЕМ < 35583 











ЗАЕЕ: 
ЗАРЕ: * ж 
SAFF: * — VIDEO FIELD * 
ЗАРЕ: * FORMATTER SUB * 
ЗАРЕ: * ҮЕЕБ.ЕМРТҮ * 
ЗАРЕ: * * 
BAFF: * — (SBAFF.8D07) я 
ЗАРЕ: * * 
ВАЕР: * VERSION 1.0 * 
ВАРЕ: * ( 8-25-81) * 
ЗАРЕ: * * 
ВАЕР: * COPYRIGHT 1981 * 
SAFF: * BY DON LANCASTER * 
ЗАЕЕ: * AND SYNERGETICS ж 
ЗАРЕ: * * 
ЗАРЕ: * ALL COMMERCIAL * 
ЗАРЕ: * RIGHTS RESERVED * 
ВАЕЕ: ж х 
SAFF: ы on eee 
ЗАРЕ: THIS PROGRAM LETS YOU MIX 
ВАЕР: AND MATCH SCREEN MODES IN 
ЗАРЕ: MANY DIFFERENT COMBINATIONS. 
ВАЕР: SCREEN MODE CAN ВЕ CHANGED 
ЗАРЕ: ONCE EACH HBLANK TIME USING 
BAFF: FILE "VPATRN". 
ЗАРЕ: SCREEN MODE CAN ВЕ CHANGED 
SAFF: UP TO TEN TIMES PER H SCAN 
ВАЕЕ: USING FILES "НРАТЇ" THROUGH 
ЗАРР: "ВРАТА". FOUR OR FEWER 
ЗАРЕ: H PATTERNS ARE ALLOWED. 
БАРР: 38 ; SEE ENHANCEMENT #5 OF 
ВАЕЕ: 39 ENHANCING YOUR APPLE ТІ, я 
SAFF: VOL I FOR FULL USE DETAILS. 
ВАРЕ: 42 : ТО USE, SET UP PATTERN FILES 
ЗАЕЕ: 43 ; THEN JSR $8800 FROM MACHINE 
ВАЕЕ: 44 ; LANGUAGE OR CALL 35584 FROM 
ЗАРЕ: 45 ; APPLESOFT. 

LL crm 








Ї 
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PROGRAM 5-1, CONT'D... 


C060: 
C000: 
C060: 
C000: 
FCA8: 





48 DUMMY 
49 KEYBD 
50 SYNC 

51 SWITCH 
52 WAIT 





EQU 
EQU 
EQU 
ЕОО 
EQU 





LOCATION FOR NO-SWITCH 
KEY PRESS CHECK 
VBLANK VIA "Sw3" 
VFILE SWITCH LOCATION 
MONITOR DELAY SUB 
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т--- 


BAFF: 


BAFF:EA 


8800:20 


8B03:2C 
8В06:10 
8B08:2C 
8ВОВ: 30 
8ВОр:ЕА 


8824: 


8824:А0 


8826:89 
8829:30 
8B2B:10 
8820:29 
8B2F:AA 
8B30:9D 
8B33:8D 
8B36:8D 
8в39:80 
8B3C:8D 
883Р:80 
8B42:8D 
8845:30 
8848:8D 
BBAB:8D 
884Е:80 
8851:88 
8B52:F0 
8854:00 











ҮЕ 


60 
ЕВ 
60 
ЕВ 


со 


60 


60 


607 


вс 


со 


со 





вс 


PROGRAM 5-1, CONT'D... 


55 








: **** EXACT LOCK TO 


МОР 


START JSR SETUP 


EXACTF BIT SYNC 
BPL EXACTF 

BLENK BIT SYNC 
BMI BLENK 
NOP 
BPL STALL 

STALL LDA 8538 
JSR WAIT 
LDA #$34 
JSR WAIT 
LDA #$01 
JSR WAIT 
BIT SYNC 
BPL STALL 


; **** START OF FIELD **** 


NEWFLD ГОУ #8со 


NXTLNL LDA \УРАТЕМ,У 
BMI НРАТ2 

НРАТІ BPL HPl 

HPL AND #$7F 
TAX 
STA SWITCH,X 
STA DUMMY 
STA DUMMY 
STA DUMMY 
STA DUMMY 
STA DUMMY 
STA DUMMY 
STA DUMMY 
STA DUMMY 
STA DUMMY 
STA DUMMY 
DEY 
BEQ BOTTOM 
BNE NXTLNl 


FIELD START **** 


EVEN PAGE START (FOR HRCG) 


INITIALIZE KEYBOARD AND 


TIMEOUT 





LOCK TO FIELD EDGE 


FIND FIELD START 
WITH JITTER 

STALL FOR 2 CYCLES 

STALL FOR 3 CYCLES 

DELAY FOR 17029 
CLOCK CYCLES TOTAL 
USING THE MONITOR 
DELAY ROUTINE AND 
THIS LOOP TIMING. 


HAVE WE BACKED TO START? 
NO, GO BACK ONE MORE 


FOR 192 LINES 


GET LINE PATTERN 


MASK SWITCH COMMAND 





ONE LESS LINE 
AT SCREEN BOTTOM? 
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PROGRAM 5-1, CONT'D... 


8B56:B9 
8859:30 
8858:10 
8в5р:29 
ВВ5Р:АА 
8B60:9D 
8B63:8D 
8в66:80 
8в69:80 
BB6C:8D 
BB6F:8D 
8872:80 
8875:80 
8B78:8D 
BB7B:8D 
8B7E:8D 
8881:88 
8882:F0 
8884:00 


8886:4C 


8889:89 
888С:30 
8B8E:10 
8в90:29 
8В92:АА 
8893:9D 
8в96:80 
8в99:80 
BB9C:8D 
BB9F:8D 
BBA2:8D 
8BA5:8D 
8BA8:8D 
BBAB:8D 
BBAE:8D 
8BB1:8D 
8BB4:88 
BBB5:FO 
Ввв7:р0 


00 
ро 
00 
7Е 


00 
60 
60 
60 
60 
60 
60 
60 
60 
60 
60 


02 
ро 


с2 


вс 


20 
со 
со 
со 
со 
со 
co 
co 
со 
co 
co 


вс 


вс 


со 
со 
со 
со 
co 
co 
co 
co 
co 
co 
co 


102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 


122 


124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 


NXTLN4 


НРАТ4 
НР4 


BOTTOM 


NXTLN2 


HPAT2 
HP2 





LDA 
BMI 
BPL 
AND 
TAX 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
DEY 
BEQ 
BNE 


JMP 


LDA 
BMI 
BPL 
AND 
TAX 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
DEY 
BEQ 
BNE 


VPATRN,Y 
НРАТ1 
НР4 

#37Е 


SWITCE,X 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 


BOTTOM 
NXTLN4 


BOTTMl 


VPATRN,Y 
HPAT3 
HP2 

#$7F 


SWITCH,X 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 


BOTTOM 
NXTLN2 





GET LINE PATTERN 


MASK SWITCH COMMAND 


ONE LESS LINE 
AT SCREEN BOTTOM? ! 


"SPLICE" RELATIVE BRANCH 


GET LINE PATTERN 


MASK SWITCH COMMAND 





жалан 
ONE LESS LINE 
AT SCREEN BOTTOM? 











126 Enhancement 5 





























20 
АВ 
14 
АВ 
06 


PROGRAM 5-1, CONT'D... 





FC 


FC 


146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 


167 


169 
170 
171 
172 
173 


NXTLN3 


HPAT3 
НРЗ 


LDA 
BMI 
BPL 
AND 
TAX 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
DEY 


BEQ 
BNE 


VPATRN, У 
HPAT4 
НРЗ 

#$7Е 


SWITCH,X 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 
DUMMY 


BOTTOM 
NXTLN3 


GET LINE PATTERN 


MASK SWITCH COMMAND 


ONE LESS LINE 
AT SCREEN BOTTOM? 


***** VBLANKING DELAY ***** 


VBSTAL 


LDA 
JSR 
LDA 
JSR 
LDA 


8920 
WAIT 
#914 
WAIT 
%506 
WAIT 





DELAY FOR 4472 
CPU CYCLES 
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PROGRAM 5-1, CONT'D... * 


8С00:60 60 60 179 VPATRN DFB 96,96,96,96,96,96,96,96, 
96, 96,96, 96,96,96,96,96 

8с03:60 60 60 

8C06:60 60 60 

8c09:60 60 60 

8С0С:60 60 60 

8С0Е:60 

8С10:60 60.60 180 DFB 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8С13:60 60 60 

8C16:60 60 60 

8С19:60 60 60 

8C1C:60 60 60 

8С1Е:60 

8С20:60 60 60 181 БЕВ 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8С23:60 60 60 

8С26:60 60 60 

8С29:60 60 60 

8C2C:60 60 60 | 





8C2F:60 

8с30:60 60 60 182 рЕВ 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8c33:60 60 60 | 

8С36:60 60 60 

8c39:60 60 60 

8c3c:60 60 60 

BC3F:60 

8C40:60 60 60 183 рЕВ 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 

8с43:60 60 60 

8с46:60 60 60 

8с49:60 60 60 

Вс4с:60 60 60 | 

ВС4Р:60 | 

8С50:60 60 60 184 DFB 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 





8С53:60 60 60 

8С56:60 60 60 | 

8С59:60 60 60 

8с5с:60 60 60 

BC5P:60 

8c60:60 60 60 185 DFB 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 





8C63:60 60 60 

8С66:60 60 60 

8C69:60 60 60 

8C6C:60 60 60 

BC6F:60 -+ 

8С70:60 60 60 186 DFB 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 





8C73:60 60 60 
8С76:60 60 60 




















да 
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PROGRAM 5-1, CONT'D... 


8C80:60 60 


8C83:60 60 
8С86:60 60 
8С89:60 60 
8с8с:60 60 
ВСВЕ:60 

8c90:60 60 


8C93:60 60 
8с96:60 60 
8C99:60 60 
8C9C:60 60 
8С9Р:60 

8СА0:60 60 


8СА3:60 60 
8СА6:60 60 
8СА9:60 60 
ВСАС:60 60 
8САР:60 

8СВ0:60 60 


8CB3:60 60 
BCB6:60 60 
8CB9:60 60 
BCBC:60 60 
BCBF:60 

BCCO:60 60 


всс2: 


8сс2:20 св 
8cc5:20 E9 
8сс8:4с 24 


60 


8B 
8B 


187 


188 


189 


190 


191 


193 


DFB 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 


DFB 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 


БЕВ 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 


DFB 96,96,96,96,96,96,96,96, 
96,96,96,96,96,96,96,96 


ОРВ 96,96 


; — **** KEYPRESSED AND TIMEOUT **** 


195 ВОТТМІ JSR KEYTIME ; TAKE CARE OF EXIT 


196 
197 


JSR VBSTAL ; DELAY TILL NEXT FIELD 
JMP NEWFLD 
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PROGRAM 5-1, CONT'D... 





08 202 
00 со 203 
06 204 
205 
206 
207 
208 
209 
210 
Ер 8С 211 










212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
























232 
233 
8CFD:00 234 





BCFE:AD FB 8С 236 
237 
238 
239 








NOKEY 


KEYOK 


NOTIME 


NOMULT 


TIMEOK 


CONTROL 
TIMER 
TIMEX 


SETUP 


FB 8C 201 KEYTIME BIT 


BPL 
BIT 
BPL 
PLA 
PLA 
RTS 
NOP 
НОР 
МОР 
INC 


BIT 
вус 
LDA 
AND 
BNE 
DEC 
BNE 
PLA 
PLA 


*** SUCCESSFUL ASSEMBLY: NO ERRORS 





CONTROL 
NOKEY 
KEYBD 
KEYOK 


TIMEX 


CONTROL 
NOTIME 
#$1Е 
ТІМЕХ 
NOMULT 
TIMER 
TIMEOK 


$c4 
$00 
$00 


CONTROL 
%5ЗЕ 
ТІМЕВ 


15 КЕҮ ЕХІТ АСТІУЕ? 


ІООК РОВ КЕҮ 


МОТ ТНЕКЕ? 
РОР SUBROUTINE 


ЕХІТ 
EQUALIZE 6 


INCREMENT TIMEOUT 
MULTIPLIER 
Is TIMER ACTIVE? 


MASK FOR 1/64 
AND TEST MULTIPLIER 


ONE LESS COUNT 
DONE? 
POP SUBROUTINE 


EXIT 
EQUALIZE 8 


EQUALIZE 8 


RETURN TO NEXT SCAN 


ARMS KP AND SETS TIMEOUT 
COUNTER FOR TIMEOUT 
TIMEOUT * 64 MULTIPLIER 


INITIALIZE TIMEOUT 
MASK TIMEOUT BITS 


AND CONTINUE 
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PROGRAM 5-2 
FUN WITH MIXED FIELDS 








LANGUAGE: 


10 REM 
12 REM 
14 REM 
16 REM 
18 REM 
20 REM 
22 REM 
23 REM 
24 REM 
26 REM 
28 REM 
30 REM 
32 REM 
34 REM 
36 REM 
38 REM 





50 REM 
52 REM 
54 REM 
56 REM 
58 REM 


60 REM 
62 REM 
64 REM 
66 REM 
68 REM 


70 REM 


74 REM 
76 REM 








——— 


72 REM: 


APPLESOFT 


BE E A ee 


FUN WITH 
MIXED FIELDS 


VERSION 1.0 
(9-26-81) 


COPYRIGHT 1981 
BY DON LANCASTER 
AND SYNERGETICS 


ALL COMMERCIAL 
RIGHTS RESERVED 


„ея ж кж ея жа 
Хиєвжиөөлжи жэл» 


RRR RRR RRR 


THIS PROGRAM SHOWS YOU 
HOW TO MIX AND MATCH 
TEXT, LORES, AND HIRES 
ANYWHERE ON THE SCREEN 
IN ANY COMBINATION. 


THE FIELD SYNC HARDWARE 
MOD AND SUBROUTINES 
VFFS.BOXES, VFFS.GRAPH, 
VFFS.GIRLS AND VFFS.BYE 
ARE NEEDED. 


SEE ENHANCEMENTS %4, 
35, AND 86 OF ENHANCING 
YOUR APPLE II, VOL I 
FOR MORE USE DETAILS. 


100 НІМЕМ: 35500: REM PROTECT 
VFFS SPACE 

110 HGR 
INITIALIZE ALL 


: TEXT : HOME : GR : REM 


NEEDS: FIELD SYNC MOD 
HIMEM « 35583 
VFFS. BOXES 
VFFS. GRAPH 
VFFS. GIRLS 
VFFS. BYE 
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PROGRAM 5-2, CONT'D... 


1004 PRINT 


CTRL D 
1010 SPEED= 10 


НТАВ 





тн 





ELDS 
1040 SPEED= 255: 


1050 COLOR= 1 
AT 11: HLIN 
22,32 АТ 18 
АТ 25: HLIN 


22,32 АТ 32 


25,32 АТ 16 





: NEXT N 


35584 
1145 REM 


1170 HPLOT 12,90 


1190 CALL 35584: 

































1000 REM ** TITLE BOXES ** 


1005 PRINT "BLOAD VFFS.BOXES": REM 


1020 УТАВ 8: НТАВ 9: PRINT " FU 


25: PRINT " WI 


1030 VTAB 15: НТАВ 9: PRINT " MI 
HTAB 25: PRINT " FI 


REM 


1080 FOR N = 1 TO 3500: NEXT N 
1090 HLIN 6,16 AT 11: HLIN 22,32 


6,16 AT 18: НІМ 


1100 HLIN 6,16 AT 25: HLIN 22,32 


6,16 AT 32: HLIN 


1110 VLIN 11,18 AT 6: VLIN 25,32 
AT 6: VLIN 11,18 AT 16: VLIN 


1120 VLIN 11,18 AT 22: VLIN 25,3 
2 AT 22: VLIN 11,18 AT 32: VLIN 


25,32 AT 32 
1125 REM 
1130 PRINT "": FOR N - 1 TO 3500 


1140 PRINT "": POKE 36091,212: CALL 


1150 HGR : HCOLOR- 2: POKE 49234 


‚0 

1160 HPLOT 12,8 ТО 258,8 TO 259, 
85 ТО 12,85 ТО 12,8 

1169 РОКЕ 49168,0 


то 258,90 ТО 25 


82170 ТО 12,170 ТО 12,90 
1180 FOR М = 1 TO 3500: NEXT М: PRINT 


REM MIX FIELDS 
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2000 


2006 
2010 
2015 


2020 
2030 


2040 
2050 
2060 
2070 
2080 
2090 
2100 
2110 
2120 
2130 
2140 
2150 
2160 
2170 


2180 


2190 
2191 


2192 
2193 


PROGRAM 5-2, CONT'D... 
























REM %% GRAPH AND TITLE ** 


H = 62:V = 160 

TEXT : HOME : SPEED= 100 
PRINT "BLOAD VFFS.GRAPH": REM 
CTRL D 

PRINT " DIPTHONG-SNORG 
EL CORRELATIONS:" 

PRINT " 444... 
PRINT " 
PRINT 
PRINT 
PRINT 
PRINT " 
PRINT " 
PRINT " 
PRINT “ 
PRINT " 
PRINT “ 
PRINT " 
: PRINT 
PRINT : PRINT " URS 
PRINT : PRINT " 9 
1 2 3 4 5 6 т 
PRINT : PRINT " 
DIPTHONGS 

VTAB HTAB 0: PRINT " 
HGR : HCOLOR= 1: POKE 49234 

10 

HPLOT 63,156 TO 255,156 
HCOLOR= 1: HPLOT 87,157 TO 
87,165: HPLOT 115,157 TO 115 
‚165: HPLOT 143,157 ТО 143,1 
65 

HPLOT 171,157 TO 171,165: HPLOT 
199,157 TO 199,165: HPLOT 22 
7,157 TO 227,165: HPLOT 255, 

157 TO 255,165 

GOSUB 20000: REM PLOT 

HCOLOR= 7: HPLOT 229,32 TO 
229,120 

POKE 36091,208: CALL 35584 
FLASH : VTAB HTAB 34: PRINT 
"1066" 

VTAB 15: HTAB 34: PRINT "14 

92" 

HCOLOR= 7: HPLOT 229,28 TO 
229,128 

NORMAL : CALL 35584: REM M 

IX FIELDS 

REM 











SPEED= 




































255 
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PROGRAM 5-2, CONT'D... 
3000 REM ** GIRLS ** 


3010 GR : CALL - 1998: POKE - 
16302, 0 
3020 PRINT "BLOAD VFFS.GIRLS": REM 


3100 FOR N - 1 TO 10: READ L: COLOR- 
N: HLIN 0,L AT (4 * N - 1): FOR 
К = 1 TO 200: NEXT КМ 
3105 : FOR N = 1 TO 2000: NEXT N 
3107 HGR : HCOLOR- 3: HPLOT 4,17 
4 TO 240,174 TO 243,179 TO 2 
46,169 TO 249,174 TO 279,174 | 


3108 РОКЕ - 16302,0: 
3110 HPLOT 4,175 ТО 4,180: HPLOT 1 
46,175 ТО 46,180: HPLOT 88,1 
75 ТО 88,180: HPLOT 130,175 ТО 
130,180: HPLOT 172,175 ТО 17 | 
2,180 
3111 HPLOT 214,175 TO 214,180: HPLOT 
270,175 ТО 270,180 1 
3115 FOR М = 1 TO 23 STEP 2 H 
3116 УТАВ (N): FOR K = 0 TO 39: PRINT i 
" ";: NEXT К,М | 
3120 FOR N = 1 TO 10: READ 65: УТАВ 1 
1 + 2 * N: PRINT G$: NEXT N | 
3130 PRINT : PRINT : PRINT "0 { 
6 8 10 
POKE 2039,160: REM 
AVOID SCROLL 
3190 POKE 36091, 212 
3200 CALL 35584: REM MIX FIELDS 








3990 POKE 16368,0: REM RESET KE 
Y STROB 




















134 Enhancement 5 














PROGRAM 5:2, CONT'D... 


4000 
4005 


4008 
4009 


4010 


4015 
4020 


4022 


4024 


4026 








4027 


4028 


4029 


4030 


4032 


4034 


4099 





REM %%% BYE BYE **+ 


PRINT : PRINT "BLOAD VFFS.B 
YE"; REM CTRL D 

GR : TEXT 

POKE - 16368,0: GR : TEXT 


HOME : VTAB 7: HTAB 20: PRINT 





= 1 TO 1000: NEXT N 
HGR : HCOLOR- 5: HPLOT 143, 
86 TO 143,79: HPLOT 145,86 TO 
145,79: HPLOT 141,78 TO 141, 
77: HPLOT 139,78 TO 139,77: HPLOT 
147,78 TO 147,77: HPLOT 149, 
78 TO 149,77 

HPLOT 137,76 TO 137,73: HPLOT 
135,76 TO 135,73: HPLOT 151, 
76 TO 151,73: HPLOT 153,76 TO 
153,73 

HPLOT 107,73 TO 107,86: HPLOT 
109,73 TO 109,86: HPLOT 119, 
75 TO 119,78: HPLOT 121,75 TO 
121,78: HPLOT 119,81 TO 119, 
84: HPLOT 121,81 TO 121,84 
HPLOT 107,73 TO 117,73: HPLOT 
107,74 TO 117,74: HPLOT 107, 
79 TO 117,79: HPLOT 107,80 TO 
117,80: HPLOT 107,85 TO 117, 
85: HPLÓT 107,86 TO 117,86 
HPLOT 163,73 TO 163,86: HPLOT 
165,73 TO 165,86: HPLOT 163, 
73 TO 179,73: HPLOT 163,74 TO 
179,74 

HPLOT 163,85 TO 179,85: HPLOT 
163,86 TO 179,86: HPLOT 163, 
79 TO 175,79: HPLOT 163,80 TO 
175,80 

COLOR- 0: FOR N - 25 TO 39: 
HLIN 0,39 AT N: NEXT N 
COLOR- 3: HLIN 11,14 AT 25: 
HLIN 11,14 AT 28: HLIN 11,1 
4 AT 31: VLIN 25,31 AT 11: VLIN 
26,27 АТ 15: УШІН 29,30 АТ 1 

5 


VLIN 25,26 AT 18: VLIN 27,2 

7 AT 19: VLIN 28,31 AT 20: VLIN 
27,27 АТ 21: УШІН 25,26 АТ 2 

2 


VLIN 25,31 AT 25: HLIN 25,2 

9 AT 25: HLIN 25,28 AT 28: HLIN 
25,29 AT 31 

POKE 36091,128 























ш 
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PROGRAM 5:2, CONT'D... 





4100 CALL 35584: REM MIX FIELDS 


4200 PRINT : PRINT "RUN MENU": REM 
CTRL D 

4201 REM DELETE 4200 IF AUTO-ME 
NU IS NOT IN USE 

4210 END 





20000 REM ** SNORGEL CURVES ** 


20005 HCOLOR= 3 | 
20010 FOR X = 1 TO 200 | 
20020 Y = (1- (2.718) ^ (-X / 

50)) | 
20030 2 = Y * (2.718 ~ ( - X / 60 


1) 
20040 HPLOT Х + 61,159 - 137 * У | 
! 


20050 HPLOT X + 61,159 - 457 "1 





20060 МЕХТ Х | 
29999 RETURN | 
30000 DATA 2,6,9,16,21,24,27,29 | 

,31,39 | 


| 

| 

30100 DATA VELMA,GERTRUDE,CHARI | 
ТУ, МОВЕЕМ, EMILY, PEGGY, ELAIN | 

Е, SAMANTHA, RACHAEL, YVONNE | 
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KEYPRESSED EXIT TIMED EXIT DISPLAY TIME 5 
1 = activate 1 = timed Six bits hold the 
O = disable 0- infinite number of half- seconds 


in straight binary 


The CONTROL file is presently located at hex 58СҒВ (decimal 36091). 





The values shown give a keypressed exit along with a timeout exit 
after seven seconds. 


Some CONTROL file use examples: 





1. Keypressed exit only—use hex $80 or decimal 128. 

2. Four-second display only—use hex $48 or decimal 72. 

3. Ғош-весопа display with keypressed exit—use hex $C8 or 
decimal 200. 

4. Eight-second display only—use hex $50 or decimal 80. 

5. Eight-second display with keypressed exit—use hex 800 or 
decimal 208. 











To set up CONTROL in hex, start with $00 and add $80 if keypressed 
exit is wanted. Add $40 if timeout is wanted. Add TWICE the number 
of seconds of timeout to this value (max. timeout value = $3F). Store 
this value in $8CFB. 


To set up CONTROL in decimal, start with 0 and add 128 if keypressed 
exit is wanted. Add 64 if timeout is wanted. Add TWICE the number of 
seconds of timeout to this value (max. timeout value = 63). Poke this 
value into 36091. 


Do not use a CONTROL value of hex $00 or a decimal 0 as this will give 
а permanent display. 











Fig. 5-1. CONTROL 





used in VFFS. 


bits hold a binary number equal to the number of Рай seconds you wish to 
display. For instance, for a ten-second display, you would load decimal twenty, 
or hex $14, into these six bytes. 

Timeout range goes from one-half a second to thirty-two seconds, with the 
option of an "infinite" timeout exited with a pressed key. 

Next are the HPAT files, short for Horizontal Patterns. The following example 
shows us the HPAT addresses and data value. There are four possible horizontal 
pattern files used in VFFS. These files decide which soft switch is flipped in any 
of ten exact horizontal screen positions. 

The files are called НРАТ! through HPAT4. The display always starts with 
HPAT1. Each HPAT file continues for a number of scan lines set by the УРАТ 
file shown in Table 5-1. While the HPAT files must be sequenced in order, they 
can repeat as often as you like each field. 


Ё 
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Here are the present addresses of the pattern files 





HPAT1 ADDRESSES 


HPAT2 ADDRESSES 





Switch-on Hex Decimal 
Character Address Address 


58834 35636 
58837 35639 
$8B3A 35642 
88830 35645 


Боко 


16 58В40 35648 
20 58843 35651 
24 $8B46 35654 
28 58849 35657 


32 58В4С 35660 
36 $8B4F 35663 








HPAT3 ADDRESSES 








Switch-on Hex Decimal 
Character Address Address 


0 58897 35735 
4 58894 35738 
8 58890 35741 
2 $8BAO 22744 


16 $8BA3 35747 
20 $8BA6 35750 
24 $8BA9 35753 
28 $8BAC 35756 


32 $8BAF 35759 
36 $8882 35762 





НРАТ4 ADDRESSES 





Switch-on Hex Decimal 
Character Address Address 


0 $8BC7 35783 
4 $8BCA 35786 
8 $8BCD 35789 
2 58800 35792 


16 58803 35795 
20 58806 35798 
24 58809 35801 
28 $8BDC 35804 


32 $8BDF 35807 
36 $8BE2 35810 














Switch-on Hex Decimal 
Character Address Address 


0 58864 35684 
4 58867 35687 
в $8B6A 35690 
12 $8B6D 35693 


16 $8870 35696 
20 $8873 35699 
24 $8876 35702 
28 58879 35705 


32 5887С 35708 
36 $887F 35711 





Note that any address іп the |/O space below $C100 may also be flipped by 
using its hex address minus 5С000, or its decimal equivalent. Note, also, that 
any change or relocation of the VFFS program will change all these address 


locations. 


HPAT is really working code rather than a true file, so its soft switching “file” 
values only show up every third byte. НРАТ splits up the screen horizontally 
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Here are the data values used in ап HPAT Ше. ... 





HPAT DATA VALUES 








Switch Hex Decimal 


GraphicsON $50 80 
Text ON $51 81 
Full Screen $52 82 
MixedGraphics $53 83 


Page ONE 554 84 
Раве ТУУО 555 85 
LORESGraphics $56 86 
HIRES Graphics $57 87 


DoNothing $60 96 





into ten groups of four characters each. At the beginning of each four-character 
slot, you have the option of flipping one soft switch. 
For instance, suppose we use this HPAT code . . . 


8833: ВО 60 CO ЭТА DUMMY  ; Flipdummysoftswitch 
8836: 8D 50 CO STA TEXT 2 Switch to text 

8839: BD 60 CO STA DUMMY ; Flipdummysoftswitch 
883С: BD 60 СО STA DUMMY ; Flipdummysoft witch 
883F. 8D 51 CO STA GRAFIX ; Switch o graphics 


8842: BD 60 СО STA DUMMY ; Flipdummysoft switch 
8845: 80 60 CO STA DUMMY ; Flipdummysoftswitch 
8846: 8D 60 CO STA DUMMY ; Flipdummysoftswitch 
8848: 8D 60 СО STA DUMMY ; Flipdummysoit switch 
884Е: BD 60 CO ЭТА DUMMY ; Flipdummy softswitch 


Whatthis will do is display the first four characters as graphics, the next twelve 
as text, and the remainder of the line as graphics again. Which is graphics and 
which is page text is decided by how the other soft switches have been previ- 
ously flipped. 

Note that you only have to flip a soft switch when you want to produce a 
change in the output mode. If you flip to text, you stay that way till you flip to 
something else. 

Each STA absolute store command takes 4 CPU clock cycles, which is equal 
to 4 characters. Thus, thé 10 switch flippings will equal the horizontal live- 
character scan time of 40 CPU clock cycles. 

To use this particular HPAT file, we access it with some machine-language 
code that goes through the “Не” exactly once each horizontal line. The timing 
is very carefully set up so that the first switch flips before character Zero, the 
second one before character Four, the next one before character Eight, and so 

across the screen to the final switch that flips before character Thirty-six. 

Because our back is to the wall with CPU operating speeds, we aren't free to 
flip only those switches we want to. Instead, we must flip 10 soft switches each 
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and every horizontal line. To do this, we fill in with dummy soft switches. A 
dummy soft switch is dne that. flips but doesn't do anything. One good dummy 
soft switch is a write to location $С060. This is the cassette IN location, and the 
hardware here is read-only. бо, you can write to location $CO60 all day long 
and nothing will happen. By Coincidence, 5С060 is also read as part of the exact 
locking code. These two uses of one address space location will not cause 
conflict. 

What you usually do is start with a VFFS.EMPTY file that holds all dummy soft 
switches. Then, you modify that file by. changing the code locations. you need 
to flip the “live” switches you really want in the exact slots where you want 
them. The easiest way to change these locations is to display the file in machine 
language and, then, use the monitor commands to modify only the locations you 
want. You сап also change a VFFS file by Poking from Applesoft, by reading 
Applesoft data statements, by transferring the commands from another ma- 
chine-language file, or by reading a new "file" off your disk. 

If we had only one HPAT file, we could only have one combination of text, 
HIRES, and LORES which would have to repeat each and every horizontal line. 
all the way down the screen. At the other extreme, we could have 192 separate 
HPAT files that would let us change each horizontal line any way we liked, 
separate from all the others. But this, of course, would take bunches of code and 
would be horribly complex, 

Instead, we have shown you four НРАТ files, called НРАТТ through HPAT4. 
This lets you have four different horizontal patterns. We will see that we have 
an option of changing to the next HPAT file at any scan line we like. Thus, you 
could use HPATI for fifteen lines, HPAT2 for six lines, HPAT3 for 97 lines, and 
HPATA for two lines. If we like, we can 80 round and round back through the 
HPAT files as often as we wantto on the same field. The next field always restarts 
with НРАТТ. 

Four different horizontal patterns that can be repeated is more than enough 
for text insets and some really fancy field mixing, yet it keeps our program and 
Pattern files down to something manageable, 

Our final file is called VPATRN. VPATRN does two things for you. It first lets 
you flip an eleventh soft switch during each horizontal blanking time. This extra 
switch can be handy in going, say from text page One to HIRES page Two. You 
can use this extra and hidden switch any мау you want to. The second thing 
that VPATRN does for you is let you advance to the next available HPAT file 
any time that you like. 

To repeat, the VPATRN file lets you flip one soft switch invisibly during the 
blanking time of each horizontal line. It also optionally lets you change to the 
next available HPAT horizontal pattern. А cleared MSB in a VPATRN file loca- 
tion only flips a soft switch, while a ser MSB in the file both flips a soft switch 
and moves on to the next available HPAT file. Should no soft switching be 
wanted, a dummy or "do-nothing'" switch location is substituted 

Table 5-1 gives the addresses of the. VPATRN Нез .... 


Table 5-1. УРАТЕМ Vertical Pattern File Used іп VFFS 








Character LORES line. Hex Decimal 
дог. number address address 
оо 00 ассо 36032 
ол ол СВЕ 36031 
02 0? BCBE 36030 


93 B > BCBD 36029 
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Table 5-1 Cont. УРАТЕМ Vertical Pattern File Used in VFFS 
Line Character LORESIine Hex Decimal 
number anddot number address - — address 
4 04 10 8CBC 36028 
5 05 1л 8СВВ 36027 
6 06 ul BCBA 36026 
7 07 1B 8СВ9 36025 
8 10 20 всвв 36024 
9 1n л ВСВ7 36023 
10 1/2 22 8С86 36022 
" 13 25 8СВ5 36021 
12 14 xo BCB4 36020 
13 ли эл 8CB3 36019 
14 16 3/2 8С82 36018 
15 17 33 ВСВ1 36017 
16 20 40 сво 36016 
17 21 ал BCAF 36015 
18 22 an ВСАЕ 36014 
19 23 А BCAD 36013 
20 24 50 BCAC 36012 
21 25 sn BCAB 36011 
2 2! 5/2 BCAA 36010 
23 27 5/3 8СА9 36009 
24 310 6/0 ВСАВ 36008 
25 зп өл 8СА7 36007 
26 Еу 6/2 8САБ 36006 
27 33 ыз BCAS 36005 
28 за 70 8СА4 36004 
29 35 т САЗ 36003 
30 36 72 8СА2 36002 
31 37 73 8СА1 36001 
32 40 8/0 ВСАО 36000 
33 ал an 8C9F 35999 
34 42 8/2 ВСЕ 35998 
35 43 83 8C9D 35997 
36 44 90 8сэс 35996 
37 45 өл BC9B 35995 
38 4i 9/2 BC9A 35994 
39 47 93 8С99 35993 
40 50 100 8С98 35992 
“ эл 10/1 8С97 35991 
42 52 102 8С96 35990 
43 53 103 8C95 35989 
44 54 тис 8C94 35988 
45 55 ил 8С93 35987 
46 56 112 8С92 35986 
47 57 113 сет 35985 
48 6/0 120 8C90 35984 
49 61 121 BCBF 35983 
50 62 122 ВСВЕ 35982 
51 63 123 зсво 35981 
52 64 13/0 всвс 35980 
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Table 5-1 Cont. VPATRN Vertical Pattern File Used in VFFS 















i Character ОВЕ line. Hex Decimal 
anddot number address address 





56 710 140 8588 35976 
57 т мл 8С87 35975 
142 8св6 35974 


35973 


60 74 150 35972 
в 7/5 15 8свз 35971 

76 152 8082 35970 
35969 









64 35968 
65 ва 16/1 aC7F 35967 

82 162 ВСЕ 35966 
35965 








68 84 35954 
69 85 171 8C78 35963 

86 172 8С7А 35962 
35961 









72 35960 
73 өл ал 8С77 33959 

92 18/2 876 35958 
35957 













76 9/4 35956 
77 95 19 8c73 35955 

9/6 19/2 8С72 35954 
35953 


ю 100 20/0 35952 
81 10/1 20/1 BCóF 35951 

102 202 ВСБЕ 35950 
35949 









54 10/4 210 35948 
85 105 an 8C6B 35947 

2/2 8С6А 35946. 
35945 









88 то 220 35944 
89 nn 221 8С67 35943 

ил 222 8C66 35942 
35941 
















92 114 35940 
93 115 zn 8С63 35939 

116 232 BC62 35938 
35937 


96 120 24/0 35936 
97 12 24n ВСБЕ 35935 

12/2 242 CSE 35934 
35933 


100 124 25/0 35932 
101 125 25/1 8С58 35931 

126 25/2 8С5А 35930 
35929 







104 13/0 35928 
105 13 26/1 8С57 35927 

262 8С56 35926 
35925 











142 Enhancement 5 








Table 5-1 Cont. УРАТЕМ Vertical Pattern File Used іп VFFS 











Line Character Hex ‘Decimal 
number and dot address address 
108 13/4 270 acss 35924 
109 135 zn 8С53 35923 
по 13/6 272 8C52 35922 
11 13/7 273 8С51 35921 
112 140 28/0 8С50 35920 
113 лал 28/1 ВСАЕ 35919 
114 142 282 8САЕ 35918 
15 143 28/3 асар 35917 
116 14/4 29/0 сас 35916 
117 145 291 8C4B 35915 
118 146 292 8С4А. 35914 
119 147 293 8С49 35913 
120 150 зоо 8C48 35912 
121 15/1 301 8С47 35911 
122 15/2 30/2 8С46 35010 
123 15/3 303 8С45 35909 
124 15/4 зю аса 35908 
125 15/5 an 8С43 35907 
126 15/6 31/2 8С42 35906 
127 15/7 313 вся 35905 
128 160 320 8C40 35904 
129 161 321 8C3F 35903 
130 162 322 8C3E 35902 
131 163 323 8C3D 35907 
132 16/4 33/0 зсзс 35900 
133 16/5 зэл 8С38. 35899 
134 16/6 332 8C3A 35898 
135 167 333 acas 35897 
136 170 34/0 8C38 35896 
137 17л зал 8С37 35895 
138 172 342 8С36 35894 
139 178 34 8С35 35893. 
140 17/4 35/0 8C34 35892 
141 17/5 3511 8С33 35891 
142 17/6 35/2 8С32 35890 
143 127 353 8С31 35889 
144 18/0 360 8C30 35888. 
145 18/1 3e ВСЕ 35887 
146 18/2 362 8С2Е 35886 
147 18/3 363 8C2D 35885 
148 18/4 364 8C2c 35884 
149 18/5 365 8С28 35883 
150 18/5 366 8С2А. 35882 
151 187 367 8С29 35881 
152 19/0 380 8с28 35880 
153 19 зал 8С27 35879 
154 192 382 8С26 35878 
155 193 38/3 8С25 35877. 
156 19/4 390 8C24 35876 
157 195 зәл 8С23 35875 
158 19/6 392 8С22 35874 
159 197 393 8С21 35873 
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Table 5-1 Cont. VPATRN Vertical Pattern File Used in УГО 














Line Character LORES line. Hex Decimal 
number and dot number address address 
160 20/0 40/0 8C20 35872 
161 20/1 40A өсір 35871 
162 20/2 40/2 8СТЕ 35870 
163 208 408 8CID 35460 
164 20/4 41/0 ӘСІС 35868 
165 20/5 ал 8СІВ 35867 
166 20/6 412 BCIA 35866 
167 20/7 413 8с19 35865 
168 210 420 acta 35864 
169 211 42^ 8С17 35863 
170 2\2 42/2 8С16 35862 
171 213 423 BCIS 35861 
172 21/4 430 8С14 35860 
173 2/5 43/1 8СІЗ 25859 
174 216 43/2 812 35858 
175 217 43/3 8С11 35857 
176 220 44/0 аста yw 
177 221 44/1 BCOF 35855 
178 22/2 442 8С0Е 35854 
179 22/3 44/5 8с00 35853 
180 22/4 45/0 вСОС 35852 
181 22/5 45/1 всов 35851 
182 226 45/2 BCOA 35850 
183 227 45/3 8С09 35849 
184 230 46/0 8008 35848 
185 23/1 46/1 вСо7 35847 
186 23/2 462 8С06 35846 
187 233 463 8С05 35845 
188 23/4 47/0 8С04 35844 
189 235 47/1 8с03 35843 
190. 236 47/2 8С02 35842 
191 237 473 8C01 35841 








Note that any soft switch in the 1/О space below C080 may be flipped. Use 
its hex address minus $C000 if a new HPAT is not to be used, or its hex address 
minus $BF80 if a new HPAT js to be used. Note also that any change or 
relocation of the VFFS program will change all these address locations. 

There are 192 entries in the VPATRN file, arranged from the bottom to the 
top of the screen, These entries start out as $60 values which end up stored at 
5С060 as dummy writes to the cassette IN read-only location. Changing a value 
to $54, for instance, causes a soft switch to flip to page One. А $55 flips you 
to page Two, and so on. Or, for far out uses, a $59 will set annunciator ANO 
at the start of a chosen vertical line, and a $58 will clear ANO. 

На VPATRN file entry has its most significant bit set, it will flip the intended 
soft switch and automatically advance us to the next available HPAT file. If the 
VPATRN entry has its most significant bit cleared, it will flip the intended soft 
switch but will not change the HPAT file in use. 

For instance, a $51 entry will flip you to text and keep the old HPAT in use. 
А $01 will both flip you to text and advance to the next HPAT. Note that $51 
+ $80 = 501, If the most significant VPATRN file bit is set, then HPAT gets 
flipped. \f the MSB is cleared, then HPAT stays the same. 





-------:БББ:БББББ55 


! 
| 
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The following are the data values used in а VPATRN file . 














Switch Advance HPAT? HexData Decimal Data Ї 
Оо Nothing по 360 96 H 
ves SEO 224 | 
GraphicsON по 350 80 ! 
уез 500 108 Ї 
TextON no $51 вт 
yes 301 209 
Full Screen по 552 82 
yes 502 210 
Mixed Graphics no 553 83 | 
yes 503 21 k 
PageOne по 554 84 Ї 
yes 504 212 | 
| Page Two по 555 85 В 
| уе 505 213 | 
LORES Graphics no $56 86 в 
yes 506 214 | 
HIRES Graphics го 557 87 | 
yes 507 215 ! 
| 
| The main VFFS program is set ир to always start on HPAT1 at the top of the 
| screen, and continue from there. Values in the VPATRN file will decide when 
| and if a change to HPAT2, НРАТЗ, and so on, is to be done. If you are using 9 
| HPATA and you get a change command, you switch back to НРАТІ and go H 
| round and round. ; 
VFFS DETAILS 1 


Note that all these CONTROL, НРАТ, and VPATRN file locations will change 
if you relocate the program or make any other modifications to it. Н 

What you do ahead of time is make up а VFFS.EMPTY program with all 
dummy soft switches in VPATRN and the four HPAT files, along with some | 
sensible value for CONTROL, say а four-second display with keypressed active. | 
You then modify these files to do the exact display job you want. For many uses, ! 
only a few file locations need be changed. | 

A pair of worksheets that make file design a lot easier appear in Figs, 5-2 and Ї 
5-3. The easiest way I've found to change ап НРАТ ог VPATRN file is to simply 
list it in machine language on the screen, and then change the dummy locations | 
as needed. You then save VFFS under a new modifier name to pick ир these 
special locations. Ї 

To use these worksheets, first split your display up into horizontal blocks, each | 
of which has а distinct horizontal pattern. Then, write the modes into the top E 
of the HPAT file worksheet, putting a “ТЕХТ” іп the block where you want text | 
*o start appearing, and so оп. Then, put the right data value in the right box on 

їе correct НРАТ for each switch flipping. To finish your HPAT worksheet, | 
zalculate the line number ог numbers where you want to switch from НРАТТ | 
to HPAT2, and so on. Put these numbers іп the bottom boxes. 
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Now go to the VPATRN worksheet, and label the с! yeu 
positions you want. Then, substitute the code needed beside each position. чое 
that you can count in scan lines, іп 8 scan-line character units, or in 4 scan-line 
LORES units. 

When you have completed both worksheets, you should have a list of all file 
values that you need. Load VFFS.EMPTY, modiíy these file values, change 
CONTROL as needed, and resave your new VFFS under a new name. The whole 
process is much easier to do than to describe. 

Let's look at some more details of VFFS.EMPTY that appear as Program 5-1. 
A flowchart is shown in Fig. 5-4. 

To activate VFFS, you first create your own custom version and then load it 
into your Apple. Then, you do a JSR $8800 or a CALL 35584. Your VFFS will 
then do a mixed field display for you for the length of time that vou selected 
with your CONTROL data values. 

At the start of VFFS, your Appleiis still displaying whatever it happened to have 
on the screen. Nothing visible will change until an exact lock to video timing is 
completed. Once again, you must have the one-wire sync mod of the previous 
enhancement in place for mixed fields to work. 

We first do some setting up at 58800. This takes the timeout bits from 
CONTROL and moves them to a location called TIMER where they сап he 
counted down for timeout. We then find the exact start of a video field using 
code we borrowed from EXACTF of the last enhancement. This code must have 
the field sync modification of Enhancement 4 to work. What EXACTF does is 
find the beginning of a field with some jitter and, then, backs up one CPU clock 
cycle per field till it finds an exact field start. 

We get to $8824 exactly at the start of a field. We call this location NEWFLD 
since it is the point we will return 10 after each field is complete. Timing from 
now on is exactly controlled to take up precisely опе field per trip around. Up 
to this point, the Apple is still displaying whatever it happened to be showing 
before we began. 

NEWFLD tells us the number of live scan lines we are to use. This is usually 
hex $С0 or decimal 192, The number of live scan lines is put in the Y register 
and Y counts the lines down for us. We then grab a value from the VPATRN 
file for the top line. This is done with an indexed load, taking the sum of the start 
of the VATRN file at 58С00 and the value in Y. Thus, our top line appears as 
VPATRN byte $8CCO. 

We next test the value found at $8CCO to see if we are to flip to the next 
НРАТ. If $8CCO has 15 MSB cleared, we use HPAT1; if the MSB is set, we switch 
to HPAT2. This is done with the ВМ! test at 48829. 

Assuming that we don't want to change HPAT just yet, we go on through the 
code starting at $8B2F. We first flip the VPATRN byte switch invisibly during 
the blanking time and, then, go on to switch up to ten locations set by the HPATT 
file. 

We reach the right end of the screen on the first scan line when we get to 
$8B51. We subtract one line from our scan counter and repeat the process, 
taking exactly 65 CPU cycles to get right back where we started from, but one 
horizontal scan line down. 

This goes on and on until we either reach the bottom of the screen, or else, 
until we find a VATRN value that flips to us to HPAT2. The time it takes to switch 
between HPAT files is exactly the same as the time it takes to continue with the 
same HPAT file. The apparent order of the HPAT files is "juggled" in the 
program to keep all the relative branches from pattern to pattern in range. 

The process repeats every scan line. A VPATRN byte is gotten and tested to 
see if a switch to the next HPAT is needed, Then, the chosen HPAT scan 15 done, 
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VERTICAL PATTERN WORKSHEET FOR [VFFS. 




















































































































































































































































































































CHARACTER 0 CHARACTER 5 CHARACTER 12 CHARACTER 18 
о seco | 48 сю | 95 isaceo | 14 $8030 | 
1 SƏCBF 49 засве. L4 Secor 145| S8C2F 
2 ssec | so заса | Ф| сек | 16 2 
3 sco | 5 засво | % засво | 16) $8020 
сас | % жас | юр | Г|нсєс | 148 сс 
5 засвв | 53 засав | 101 secte | 140 3028 
в secaa | sa засал | 102 secta | 150 30028 
т sacas 55 secos 103| $8059 151 $8029 
TORES OA RES 1213 LORES 2425 CORES 3837 
CHARACTER т CHARACTER 7 CHARACTER 13 CHARACTER 19 | 
Li засва в secas 104| | 88258. 152 $8028 
8 scm | 57 seca? | 105 58057 | 153 Scar 
ю sacas | 58 secas | 10) зеге | 14 38028 
bi Secas | ӨГ-1 1 он | 107 нее | Е secre | 
E scm | 60 жом | 14 sac | 1% иси 
EJ засвз 61 $8083 109] 58053) 157| 58С23 
м scm | e засаг | 10 58052 | 158 38022 
ю 38С81 63 58С81 m 58051 159| |58С21 
TORES 2/3 TORES 14/15 LORES 2827 LORES тало 
CHARACTER 2 CHARACTER 8 CHARACTER 14 CHARACTER 20 | 
ю simo | ва sceo | 10 secs | 160 Г 58620 
т ЗАР | ез ser | 10 sacar | 161 [еси 
в юАЕ | 06 secre | 114 зов | тво ис ! 
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22 САА. 70 168| 38С!А 
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в нем | 74 E 30010 
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E] secas | 7 173 $8013 il 
» саг | ж ИД sco || 
з scai | 7 1% $8611 | 
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CHARACTER 4 CHARACTER 16 CHARACTER 16 CHARACTER 22 
2 Весло | 0 заст | 128 жою | те сю | 
эз |58С9Ғ в 58С3Ғ 129] з8сзғ 171| $8СОЕ H 
з сэ | гг $eceE | 150] |sscaE | 178 58С0Е 
ЭГ зоо | вз зов | 131 3630 | 179 засо | 
ГІ Пжок | ж 14062 | 132 scac | 180 58С0С: 1 
37 secos | 85 58088 | 133] sacaa | ав: асов | 
38 |58СЗА | 88 SeCA | 134 |З8СЗА | 182 secoa | 
E! mc | 87 сә | 115 scs | ies 2000 
CORES 201 LORES зал LORES 3445 
‘CHARACTER 11 CHARACTER 17 CHARACTER 23 | 
4 sacos | в асаа. | x sacos | 184 [..] s&cos М 
а ист | 9 sce | 137 |с? | ев зас 
а sects | o secas | 1af acus | ш [асов 
8 secos | о! ees | + cas | 187 sacos 
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Fig.5-3. Vertical pattern VFFS worksheet. 
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Fig. 5-4. Flowchart of VFFS. 
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flipping switches across the live part of the screen. During horizontal retrace, we 
knock one off the line number and get a new VPATRN value. 

Eventually, we reach the bottom of the screen. Our test of the line number 
fails, and we drop first to location BOTTOM and, then, jump to ВОТТМ1. This 
absolute jump is needed because we go out of the allowed range for a relative 
jump. It is also more flexible this way, since you can substitute your own code 
for the entire vertical blanking interval. 

Our default processing for the vertical blanking time starts at $8CC2. We first 
see what the keypressed and timeout sub is up to. This sub is called KEYTIME. 

KEYTIME first checks to see whether we are interested in a keypressed and 
then checks for an actual keypressed. If we want a key exit and if a key has been 
pressed, we return to the calling program in whatever language it was in. If not, 
we continue. 

KEYTIME then increments a location called TIMEX. TIMEX is a multiplier that 
multiplies each count of the timeout value in CONTROL by 32. Thus, we only 
decrement the "half-seconds'* count in TIMER only once every thirty-second 
field or, roughly, once each half second. 

A check is then made to see if timeout is active, and if we are in the magic 
1-01-32 field that lets us decrement the timeout counter. Should we timeout, we 
exit to the main program. If not, we go back to our BOTTM1 processing. 

Note two things. First, the code in KEYTIME seems a little complex, but it has 
to be done this way so that each and every possible route through the code, that 
returns us to a repeat field scan, takes up exactly the same time. Anything else 
you do during the vertical blanking interval must also be set up to exactly take 
a precise and known number of CPU clock cycles for each and every possible 
direction through the code. 

Secondly, note we have two different types of subroutine returns. If we simply 
RTS, then we kick back into our calling program, which is the BOTTM1 code 
of VFFS. If we pop the stack twice, removing the return address to VFFS, then 
we return to the main calling program in whatever language it happens to be. 
So, do an RTS to get back to VFFS, or else, a PLA-PLA-RTS to get back to your 
main calling program. 

Assuming we haven't pressed a key or used up our timeout, we will normally 
return to ВОТТМ1. At this point, we have to delay exactly 4472 CPU cycles 
to get to the exact start of a new field. This is handled by a subroutine called 
VBSTAL. VBSTAL provides our vertical blanking delay for us. It does this by 
calling the WAIT delay subroutine in the monitor at $FCA8 three times over, 
with just the right magic numbers stuffed into the accumulator to give us exactly 
the delay you need. 

If you like, you can replace VBSTAL with any other program that takes exactly 
4472 CPU clock cycles to repeat. This can give you a limited amount of anima- 
tion or key entry while your mixed field display is active. Once again, the exact 
number of cycles used is critical and must be the same for each and every path 
through your code. 

When VBSTAL is complete, we jump to NEWFLD and repeat the whole game 
over and over again till our timeout is complete or a selected key is pressed. 

Your VFFS subroutine can be relocated to any protected space in memory, 
but note that all the file locations will change and all the worksheet values will 
be wrong if you try this. 

‘As a hint of some of the really mind-boggling stuff you can do with mixed 
fields, think about what happens if you modify your files while they are running, 
This lets you do video wipes and other animation, where the screen modes 
change dynamically. 

Heavy. 
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ЗИТСН RIDDANCE 


The first few times you try to use the VFFS subs, you probably will get some | 
ugly glitches messing up your display. ! 

Your most obvious glitch source is caused by you not having what you think 
you do in your VPATRN and HPAT files. Be very careful and very patient in ! 
deciding what you want to put where on the screen. Use the worksheets. Note H 
particularly that your HPAT values go every third byte in the program. When н 
you list ап НРАТ, the HPAT values usually are placed in the slot one byte higher I 
than the address shown on the screen. 

For instance, if you have an 


$8B30- 8D 60 CO STA %С060 | 


оп your НРАТ listing, it is location 58831 that holds your soft switch value, and 

NOT location 58830. The first byte of this code says to absolute store some- 

thing. The second byte tells us the exact location on a particular memory page, 

and the final byte tells us exactly which page. Your HPAT value must fit into the 

middle slot and not either of the others. Mix these up and your program bombs 

for sure. 
It is also a good idea to use every early slot left over on HPATI to reaffirm 

that your display is showing what you think it should be. As an example, you 

might want to flip the switches for page One, LORES, and full-screen display 

even if you never get out of these modes. That way, if you enter from some other 

part of a program or with a screen in the wrong mode, things will correct 

themselves immediately. 
There are two more sources of glitches. Any time you flip into or out of LORES 

on screen, you will probably get the darndest half-and-half split HIRES/text 

glitch you ever saw. This happens if you are using a Revision No. 1 or newer 

Apple and it is caused by a switching change that Apple made to pick up extra 

HIRES colors. You can reduce this ugly glitch to one that can easily be handled | 

by adding another modification to your Apple. i 
This modification is called a Glitch Stomper and is detailed in Enhancement H 

6. Your Glitch Stomper can be built for $3.00 and in a few minutes time, and 

it is easy to add to your Apple. là 
The final glitch problem comes about since there is always one character “іп 

the pipe" being processed, at the instant that you flip a soft switch . .. . 


There is always one 


character or byte “іп the 
pipe" at the instant that 
7 you flip a soft switch. 








Say you flip from text to HIRES. What this rule says is that the next text 
character after the switch flips gets displayed as HIRES lines rather than dots. Ї 
Or, going backwards, а flip from HIRES to text says that the HIRES dot pattern 
of the next byte after the switch flipping gets put on the display as a dot matrix 
character. | 
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Now, that sounds just awful. But, you can carefully make each and every 
glitch on the screen invisible with some care. You can even make a glitch work 
for you, rather than against you. 

For instance, when you go from text to LORES, exit to LORES black. If the text 
and LORES are on the same display page, the black LORES character has the 
same code as a text inverse @. 

If you go from text to HIRES, if the next text character after the last live one 
is the blank character, you will get a vertical green line on the screen as your 
first HIRES display byte. What is happening is that the least significant seven bits 
of your ASCII text character, following the last valid text character, are displayed 
as HIRES. A text blank has the binary code 1010 0000. The most significant bit 
tells us to shift to HIRES color set “1,” and the remaining “1” gives us a green 
line. 

When you are building a HIRES graph, a green vertical line may be exactly 
what you want, and we get this "free." You can get most any other HIRES 
pattern in this slot that you want, as long as all eight horizontal scan lines have 
the same pattern on them. If you force a $80 into the character slot following 
the last valid one, you will get both a black HIRES display and an invisible 
glitch. 

If you go from HIRES to text on the live part of the scan, you will get an inverse 
@ as your first text character if the HIRES display was black at this point. This 
is caused by black being all zeros in the HIRES space and an inverse @ in the 
text space. The way to get rid of your inverse @’s is to change the code on the 
HIRES page to give you one vertical line through dot number 6 of the character. 
This will exit you to an ASCII code of blank. 

Any other time that а glitch rears its ugly head, find out what character or byte 
is in which memory location. Then, find out what that character or byte looks 
like in the code that you just switched го. Then, change the character to make 
it invisible or otherwise useful 

Another obvious way to eliminate glitches is to use the VPATRN switches as 
much as possible, These switch during the horizontal blanking time and, there- 
fore, any funny stuff will be off screen. 

Glitch-riddance rules for very old “Revision Ø” Apples will be slightly more 
complicated since the switching will take place one dot into the character. Have 
fun. 

Summing ир... 


Glitches happen only during live 
scan switching. 


‘The Glitch Stomper of the next 
enhancement converts really bad 
glitches into workable ones. 


By carefully studying where the 
code comes from and where it is 

going, all glitches can be made - 
invisible, or else they can be made 

to work for you. 





Some practice is all that it takes to build yourself some completely glitch-free 
displays that will mix and match text, HIRES, and LORES in any way that you 
like. 2 
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VFFS. EMPTY 





26 60 CO 30 РВ FA 10 00 
А9 3B 20 АВ FC A9 34 20 
АВ ЕС A9 OL 20 AB РС 2С 
60 CO 10 PC А0 СО BS 00 
ВС 30 63 10 00 29 78 АА 
эр 50 cof 80 67 cO 85-60 
(25-05-67 со өр 60 co 00 
eo со өр 60 со 00 60 co 
во, 0 co во 60 

88 P0 32 DO DO B$ 00 

30 Do 10 00 29 77 AA 


Эр 00 со 
(25-80-62 co во во co ер 


со со өр 60 co бобосо 
во 60:20 80 60 co ap 60 
F0 03 Di 00 ас 62 
SC вэ 00 вс 30 30 10 00 
29 TP АА 90 00 20) 
Со вр 
о CO 80 60 со во 60 со 
loo во co ор $e 
[20 во 62 cofas 
56 ав 00-86 30 
29 7р AA эр 00 cojan 60 
D xz Ej 
во со 80 60 co 80 60 со 
во 60 co ёр 60 co во so 
(59 вр so со(88 Fo 
58-31 FER 





НРАТ 1 
FILE 


HPAT 4 
FILE 


HPAT 2 
FILE 





НРАТ 3. 
FILE 


ase е Se 


20 ла Рс ло 06 20 АВ FC 
60 49 20 1D 40 20 52 20 


во во во во вс во 60-68 
50 60 во бо 60 60 60 60 
во 40 60 60 60 50 60 so 
во 60 60 60 60 60 60 60 
во 60 60 60 60 60 60 60 
бо 60 60 60 60 60 60 60 
во 60 60 60 60 60 60 60 
во 60 во eo 60 so eo 60 

© 

E] 

@ 

е 

E] 





бо бо 60 co 60 60 60 so 
80 60 60 50 УРАТАМ 
во 60 60 60 FILE 


80 60 60 60 

80 60 60 60 

80 60 60 50 
50 60 бо 60 60 50 60 so 
eo 60 во 60 60 «o 60 so 
о 60 60 60 60 60 60 60 
во 60 60 60 60 60 60 60 
во 60 60 60 60 60 60 0 
во 60 60 60 60 60 60 60 
бо 60 бо 60 60 80 60 60 
to 60 40 60 so 

0 50 50 50 








26 00 co 10 06 68 68 60 
EA EA EA EE FD 6C QC FB 
SC 50 OF A9 19 29 го вс. 
Фо oc CE РС Өс 60 08 66 
48 60 EA EA EA EA BA EA CONTROL 
BA ва 60[24100 00 AD ТВ NE 

BC 29 3P 80 PC ёс 60 











Fig. 5-5. Hex dumps of VFFS files used in 


TWO DEMOS 


Program 5-2 is a HIRES demo program that loads several different VFFS 
subroutines for you. These subroutines are called VFFS.BOXES, VFFS.GRAPH, 
VFFS.GIRLS, and VFFS.BYE. You'll find hex dumps of these shown in Fig. 5-5. 
Once again, all of these custom field mixers are created by starting with 
VFFS.EMPTY, listing it in machine language, changing a few locations using your 
pattern worksheets, and, then, saving to disk under a new name. 

The demo program.also shows us how we can mix action during normal 
display times with stunning results during mixed field times. We've purposely 
slowed things down with SPEED commands and lengthy calculations to make 
the demo more interesting to watch. 

Our demo first mixes text with color LORES boxes and, then, for an encore, 
puts a pair of HIRES boxes around the whole works. Actually, we stay in a 
3-way HIRES-LORES-text mix all along. HIRES parts are simply black at first. 

We then draw a graph that uses HIRES for the axis and curves, and which uses 
text for the vertical and horizontal data values. Above that is a text title. Note 
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VFFS. GRAPH VFFS. GIRLS VFFS. BYE 
ЗАРЕ ЕА ЗАРР EA 

20 re вс іс 60 со 10 тв 8в00- 20 FE 8C 2с 60 cO 10 #8 
36 60 со 30 та EA 10 00 т. 808 2с 60 со 30 FB EA 10 СО 
A9 за 20 AB Ес №9 34 20 те 30 АЯ Рс 39-34 20 
E 20 A9 01 20 ла Pe 26 
60 ж 10 Pc AO CO RB 0 
ГЭ % 63 10 00 29 ТЕЛА. 
E] 52 Со во во CO во 60 
со во во со во 60 СО 80 
во 80 60 со 80 60 СО 80 60 CO 
> со вв о Gh o во co 80 07 

со то 32 ю0 

ж 50 10 00 

E] со вр 60 
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80 60 co 

сп во éa 

1002 ро 

со ве 30 

JA өр 00 

со вр 60 со во so co an 6898: со ар 60 co 80 
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со 80 60 со 88 TO СР DO 8вв0- со ар 60 CO вв 

Bo вз 00 вс 30 90 10 00 кввө- DO нэ 00 9С 30 

29 Р АА 30 00 СО 00 si босо- 29 7P АА 90 00 

со вю 60 co 00 $0 co 45 Baco- со 0D 60 co бо 

60 со 80 60 со 80 60 co 8вс0- 60 со 60 во со 

BD 60 CO вр 60 CO Bb 51 8808: 80 60 CO 80 60 

CO 8D 60 со 88 FO 9р 00 Beo- со Вр 60 со ва 

бо A9 20 20 M» FC А9-14 88Е8- 00 А9 20 20 А8 

20 AB РС A9 06 20 AB FC EBPO- 20 АВ FC AS 06 

60 20 20 20 20 20 20 20 патат 60 49 20 10 40 

51 $1 52 St 51 $1 51 St 8с00- 56 56 60 60 60 

60 60 60 

80 60 60 

60 60 60 

60 60 60 
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60 
80 60 60 
80 60 60 
80 во eo 
50 60 во 
2656 
въ во ва 
80 60 60 
СЕ 
тв вс 10 
06 вв 68 
то вс 22 
де 20 то 
бс 00 om 
ER EA A 
00 AS AD 
PC ВС 60. 
demo programs. 


the use of a vertical HIRES line in order to get rid of an on-screen glitch in line 
2220. 

After our graph is complete, we then inset some flashing text inside the HIRES 
display. It is usually very tricky to have flashing text in the middle of a HIRES 
screen. Mixed fields make it trivial. 

The subject of our next plot is obvious. We show how to do a LORES 
horizontal bar graph with text documentation. A HIRES graph axis completes the 
picture for us. » 

The final display in the Fun With Mixed Field demonstration program shows 
how you can have a LORES, HIRES, and text character on the screen at the same 
time right above each other. 

A totally different kind of Applesoft demo appears as Program 5-3. This one 
is called LORES COLORS 121 and shows 121 of the many available LORES 
colors. We purposely aren't going to tell you how this one works. But, if you 
combine the detective work you should have picked up in Enhancement 3 with 
a good understanding of your VPATRN and HPAT files from this enhancement, 
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VFFS. LORES LORES 1 (DISPLAY PAGE 1) Ї 
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ac 60 со 
30 РВ ВА 
38 РС 79. 
01 20 ла 
16 00 29 
80 50 со 
во Со 80 
80 60 со 
32 po 00 
10 00 29 
во өз co 
40 co 00 
80-60 со 
00 
за 


882 
88 
st 
г8 


sgsr: 
gasser: 
852888 


38 
за 
за 





888884188 


00 88 ва no ва 
зв 00 88 ва 00 
00 00 00 88 вв 
00 98 ээ 00 99 





27:33 37 37 37 

















ос These залаа must be ізітсіу loaded sinew they are an "IMAGE" of iex page 1 


| Fig. 5-6. Hex dumps of VFFS and SCREEN files 


you will be well on your way to thoroughly understanding some machine 
| language secrets. 


Fig. 5-6 shows us hex dumps of the VFFS.LORES subroutine, along with two 
display page files called LORES1 and LORES2. The companion diskette to this 
book has these programs ready to go, and also includes two programs called 
LORES! CREATE and LORES2 CREATE. You can modify these CREATE pro- 
grams for other LORES ‘color demonstrations. Do not run either CREATE рго- 
gram with a locked LORES1 or LORES2 on the same disk or you will get an error * 
message. 

Note that you cannot directly “hand load” LORES1 since this is on the display 
page. Instead, you save a version from $0800 to 50ВЕҒ onto your disk and, then, 
read this VERSION into $0400 to $07FF. The demo disk does all this for you. 

Oh, yes. One gotcha. Before you can use an Applesoft program such as 
LORES COLORS 121 and page Two LORES or text together, you have to make 
| sure the Applesoft program starts above memory location $0C00. The сору of 
Program 5-3 that is on the disk has an automatic repositioner built іп: The disk ~ 
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LORES 2 (DISPLAY PAGE 2) 





0800- 11 11 00 22 52 00 33 33 
0808- 20 44 44 03 55 58 00 68 

17:00 
AA MA 
20 09 
еш 
50 Pe 
4803 
зв ва 
20 00 
Fr FP 
26 03 
00 00 
16:37 


°з 
00 бе. 


3232333283835 





888 


27 07 90 08 08 
E] 


ва за 00 00 өз 20 


8888888888238 





8 
8 
3 


5 
E 














Note Pags two Wnt munt be protoced to вк на ilg. 


used in the LORES COLOR 121 demonstra 





version of LORES COLORS 121 will run just like any ordinary program. But, if 
you are trying to copy the LORES COLORS 121 program from this book, do a 
POKE 104,12 and a POKE 3072,0 from the keyboard before entering the 
program and, again, immediately before every use. Always turn your Apple off 
and back on again before running anything else on the machine. We might look 
at repositioning details in a future enhancement. 

So far, | have been able to find only 136 LORES colors. Sorry about that. | 
left the ugliest 15 colors off the display on purpose. But, even these uglies might 
be useful in order to add texture to a black and white display. How many new 
LORES colors сап you find? 

There are lots of possible VFFS options and improvements since mixed fields 
isa brand new ball game. You might like to write a program that will automatical- 
ly generate custom VFFS files for you. You might like to modify VFFS.EMPTY 
to put a “phase shifter” between the exact lock and the rest of the program. This 
lets you switch on characters 0,4,8, ..., or characters 1, 5, 9, ... , or characters 
2, 6, 10, ..., or characters 37,11, . . . ; per your choosing. The really good 
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РВООВАМ 5-3 
LORES COLORS 121 











LANGUAGE: APPLESOFT NEEDS: FIELD SYNC MOD 

VFFS. LORES 

RELOCATION ABOVE TEXT 2 

LORES 1 

LORES2 

Ч 

10 REM Ч 
12 REM ftre 
14 REM * 
l6 REM % LORES COLORS 121 
18 REM * 


* 
* 
* 
20 REM % COPYRIGHT 1981 * 
22 REM % BY DON LANCASTER * 
24 REM % AND SYNERGETICS * 
26 REM * 5 
VERSION 1.0 * 

( 9-20-81) Ж 

* 

* 

* 





* 
+ 
% ALL COMMERCIAL 
34 REM * RIGHTS RESERVED 
* 
* 


лак ааа ttt tats 





50 REM THIS PROGRAM NEEDS THE 
52 REM FIELD SYNC MODIFICATION 
54 REM AND BINARY FILES LORES1, 
56 REM LORES2, AND VFFS.LORES 
58 REM TO WORK PROPERLY. 


70 REM SEE ENHANCING YOUR 
72 REM APPLE II, VOLUME 1 
74 REM FOR MORE USE DETAILS. 





80 REM WARNING: THIS PROGRAM 
82 REM MUST BE RELOCATED 
84 REM ABOVE TEXT PAGE TWO! 


86 REM DO A POKE 3072,0: Ї 
88 REM AND A РОКЕ 104:12 
90 REM BEFORE USING. THIS 

| 





92 ЖЕМ IS DONE AUTOMATICALLY = 
94 REM IN THE VERSION ОҒ THIS 

96 REM PROGRAM ON THE DEMO 

98 REM DISK. 
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PROGRAM 5-3, CONT'D... 


100 


200 
210 
220 


300 


400 
405 


406 


410 





420 











HOME : СВ : РОКЕ - 16302,0: 
CALL - 1998: REM CLEAR FU 
LL GRAPHICS SCREEN 


PRINT "BLOAD VFFS.LORES": REM 
CTRL D 

PRINT "BLOAD LORES1": REM C 
TRL D 

PRINT "BLOAD LORES2,A$800": REM 
CTRL D 

CALL - 29952: REM MIX FIEL 
DS 


POKE - 16300,0: TEXT : HOME 


POKE 2048,0: POKE 104,8: PRINT 
: PRINT "RUN MENU" 

REM DELETE 405 IF AUTO MENU 
IS NOT IN USE 


PRINT "PLEASE TURN APPLE POWE 
R OFF AND BACK ON AGAIN BEF 
ORE RUNNING ANY OTHER PROGRA 
M. 

PRINT : PRINT : PRINT "1 HAS 
TA LA BYE BYE": VTAB 23: END 

















158 Enhancement 5 








stuff will happen when you start flipping nonobvious soft switches, for things like 
external 3-D displays, anti-aliased grey scales, and so on. And, the opportunities 
for dynamic "change-while-it's-running" field-switch animation and wipes are 
awesome, 

By the way, if you try flipping the speaker or cassette soft switches out with 
VFFS, you'll have to replace any involved HPAT “8D” absolute stores with 
“AD” absolute loads instead. Due to an Apple quirk, stores whap each soft 
switch twice. This puts the speaker cone right back where it was two mi- 
croseconds earlier and it produces no sound. 

Now, it's your turn. What can you do with mixed fields? In the back of this 
volume is a postcard. Use it to show us the best use of mixed fields that you 
can think of, Pay particular attention to flipping nonobvious switches like the 
annunciators and whatever. We'll work up the best of the best into future 
enhancements that everyone can share @ 


The following programs and files 
are included on the companion 
diskette to this volume: 


VFFS.EMPTY.SOURCE 
VEFS.EMPTY 
VFFS.BOXES. 
\VFFS.GRAPH 
VFFS.GIRLS 

VFFS.BYE 
VFIS.LORES. 

FUN WITH MIXED FIELDS. 
LORES COLORS 121 
LORES1 CREATE 
LORES2 CREATE 
LORES1 

LORES2 


Ай are fully copyable. 

















Enhancement 





GLITCH STOMPER 


This simple, three dollar, add-on 
hardware mod makes the mixed 
field displays of Enhancement 5 
even more powerful. The mod lets 
you glitchlessly switch to and from 
LORES anywhere on the screen. 


GLITCH STOMPER 


As we promised you in Enhancement 5, here is a fairly simple mixed fields 
add-on hardware mod that will eliminate the worst of the on-screen glitches as 
you switch to or from LORES on any live portion of your screen. The glitch 
stomper works on any Apple—from Revision 1 on. It costs under $3.00 and is 
fairly easy to install or remove. 

The problem we are about to attack was caused by Apple when they picked 
up the extra HIRES colors during Revision 1. Their idea was to make a few 
changes as simply and cheaply as possible to the existing Revision 0 Apple 
board. But, what they forgot, and what we are about to find out із. 





With hardware or soítware, there 
NEVER is such a thing as a small. 


change! 





7595 





160 Enhancement 6 








and even more to the point. . . 


When you do make any change in 

hardware or software, anything 1 
you ignore will surely return to 3 
haunt you. 





In the case of the Apple mod, the thing that the Apple people ignored is that 
someday someone might like to instantly switch to or from LORES while in the 
middle of a live scan. The changes that they made require one character time 
in order to complete a switch to or from LORES. During that time, you get some 
very ugly glitches that are a mix of both text and HIRES. 

Fig. 6-1 shows us the Apple circuitry that is involved in the modification. A 
one-of-eight electronic selector was originally provided at location A9 on the 
Revision 9 Apple boards. This selector switch was set up so that the code on 4 
the “A,” B," and “С” select lines picked the source of the video to be routed 1 
to the display. When the original switch was іп any of positions Zero through 
Three, you got a text output. This text output came from a 2513 dot matrix 
character generator by way of a serial video-shift register at А3. 






тизи 


Fig. 6-1. Video selector used in Revision 8 Apple boards. Line “С” unconditionally picks 
text or graphics, 


HIRES and LORES were input to positions Four through Seven of this switch. 

On Revision 0 boards, the HIRES and LORES were separated in earlier circuits d 
and one or the other, but not both, would go to selector A9. When in a graphics. 
mode, A9 would use its four graphics input positions to complete sorting out the 
dots on either a HIRES cell or a LORES color block. 

Note that the switching between text and graphics here was unconditional. Е 
Whenever select line “С” with a weight of “47” was low, you went immediately 
to the text side of the switch. When select line “С” went high, you went to the 
graphics side of the switch. Since all four low inputs went to the same text Із 
source, it didn’t matter what selector line “А” (weighted 1), and selector line 
“В” (weighted 2), were up to. 

Now for the problem. Fig. 6-2 shows the same selector switch after the HIRES 
color modification, and as used on all Apples of Revision 1 and higher. Now, В 
the bottom two switch positions are text, the next two are HIRES, and the four | 
high ones аге LORES, all separate. One of the HIRES inputs is delayed опе- | 
quarter of a color cycle from the other, giving you a choice of two sets of colors, Ї 
depending on whether the most significant bit of the HIRES word was a one ог 
a zero. ` 


PEDE, 5 





MM ME EE LL LE | 
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Nice and neat. | 

Except for the problem. To go into text or HIRES, you now һауе to рау 
attention to all three select lines, instead of using only select line “С” to uncondi- 
tionally go to text like before. Apple very carefully worked things out so that the 
select signals would point exactly to the right switch position. Lines “В” and “С” | 
must work together to unconditionally output text or HIRES. 

The only little hassle is that the logic to keep everything pointing in the right 
place ends up one character behind the character you think you are on when 
you suddenly switch display modes. It takes the Apple one character more to | 
complete the switching to or from LORES and to either text or HIRES. ! 

The result of this is an ugly glitch. Fig. 6-3 shows you what you get. When 
you suddenly switch out of LORES, you get a symbol that is split into two vertical 
halves. The top half will be the dot matrix display of the character still stuck in 
the pipe, while the bottom half will be a HIRES mapping of the actual ASCII code 
bits of that same "'in the pipe" character, Thus, the top half is the character and 
the bottom half is the code that forms that character. 


ЛЭ ° тавны 
| м0 
наво PON 
" wj oto 
iones г | 
: 
| 
Fig. 6-2. Video selector circuit used in newer Apple boards. Line “С” is no longer | 
unconditional, | 
| 








Assume you just switched trom LORES to TEXT ог HIRES 
In the middle of a horizontal ine. if the NEXT LORES value 
happens to be пех $52, here is what you get: 





ТОР HALF OF UNSTOMPED GLITCH 
|----15 DONE IN DOT MATRIX TEXT. IN THIS 
CASE, A FLASHING "R." 


TYPICAL 7 x 8 
CHARACTER CELL 
BOTTON HALF OF UNSTOMPED GLITCH 
15 DONE IN HIRES. IN THIS CASE А 
0100 101 PATTERN. 


Fig. 6-3. Typical one-character unstomped glitch that you get on a sudden mid-scan 
switch out of LORES. 


The problem to you, as field mixer, is that while you can "hide" either half 
of this glitch by a choice of what character you put here, you cannot get rid of 
both halves of the glitch at once. Something always remains to haunt you and 
foul up the display. . 
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What we have to do is make sure that your selector switch instantly goes into 
the chosen text or HIRES mode when you switch out of LORES, instead of 
waiting for the Apple circuit to straighten things out for you on the fiext character 
slot. Make this correction and you still get a "wrong" character, but the "wrong' 
character is now at least in one entire piece. By picking the character code, you 
can now make this glitch invisible, or else, have it work for you one way or 
another. We saw details on this in Enhancement 5. 

The problem lies in selector line “В.” All line “А” can do is pick even ог odd, 
50 it can’t point us temporarily to text while in HIRES, or vice versa. And, line 
“C” is what picks LORES on one hand and text or HIRES on the other. So what 
we have to do is make sure that line “В” immediately points to text or HIRES 
the instant that we do a field switch out of LORES. 

Fig. 6-4 shows the schematic of the glitch stomper. What we do is intercept 
line “В” of the selector, and force it to a “zero” the instant that we go into а 
text mode, and to a “one” the instant that we go into a HIRES mode. Should 
we be in LORES, the signal that is supposed to be on line “В” passes through 
unharmed. 

This speeds up the Apple switching logic by one character, so we can instantly 
switch to an all-text mode, an all-HIRES mode, or back to LORES anywhere on 
the screen. Any glitch that remains is in one piece and is easy to handle by 
changing its code to something useful or invisible. 

We will now show you how to make this mod using three new integrated 
circuits. While you only need one new 14-cent IC to do the job, we are going 
to chop and channel the other two in a way that the Apple warranty people 
might find suspect. When the mod is done, two of Apple's integrated circuits 

Jill be left over. You can set these aside for use in case you ever need a warranty 
repair. 

As with the hardware mods in the other enhancements, this one does in fact 
void your Apple warranty. But, if you are careful, you can easily and completely 
return things back to normal. 

Here are the parts you will need . . . 



















PARTS LIST FOR 
GLITCH STOMPER 


1) 741502 quad NOR gate 
IC (2 needed). 
7415151 1-0-8 
selector IC. 

(3 DIP socket, 16-pin, 
premium machined-pin 
style. 

41) No. 24 insulated solid 
wire, 4-1/2 inches 
long, red. 

() No. 24 insulated solid 
wire, 4-1/2 inches 
long, blue. 


( 


( ) Electronic solder (5 
inches). 
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BREAK OLD 
МЕСТОМ 

SOCKET сито DEVICE 
X [o 








741502 "PIGGYBACK" 








SHORT (979 коел 
т = GROUNI 
цах = PIN 14 = «SV DG 

PIN +6 = NO CONNECTION 





Fig. 6-4. Schematic of the glitch stomper modification. 


Here are the tools you will need . . . 


TOOLS NEEDED TO BUILD 
GLITCH STOMPER 





(17 Small soldering iron, 40 watt 
() Diagonal-cutting pliers 

() Needle nose pliers 

(3 Wire stripper 


() Piece of protective IC foam 
€ ) IC puller (optional) 
(3 Phillips screwdriver 


() Regular small screwdriver 





Construction details for your glitch stomper are shown in Fig. 6-5. Be sure to 
use a premium machined-pin DIP socket. This is the only type that can safely 
be plugged into another socket without damage. Also, be certain you understand 


how DIP pins are numbered, 


Installation is slightly harder than the earlier mods since the case of your 
Apple will have to be temporarily removed. Here is how to install your glitch 


stomper... 











INSTALLING THE 
GLITCH STOMPER 







1. Put a rug or other soft 
cover over your work 
area. 





2. Pop the cover on your 
Apple by pulling 
sharply up—first, at left 
rear and, then, right 
rear. Set the cover 
aside. 
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Turn Apple OFF. Then, 
unplug both ends of 
the Apple power cord 
and set the cord aside. 


. Remove all plug-in 


cards, cables, rf 
modulator leads, and 
other add-ons. Make a 
careful record of what 
goes where. 


Turn the Apple upside 
down onto the rug. 
Using а Phillips 
screwdriver, remove 
two screws at extreme 
rear, two on either 
extreme side, and four 
from the front. 


NOTE — Remove 
ONLY these 10 
screws. Do not let the 
case separate from the 
rest of the Apple. 


Carefully grab both the 
case and the chassis of 
the Apple and turn 
them both back 
right-side up together. 
DO NOT LET CASE 
SEPARATE FROM 
CHASSIS WHEN YOU 
DO THIS. 

Gently lift the front of 
the case only far 
enough to look inside. 
Note the keyboard 
connector. Now, lift 
the case up and back 
as far as you can 
without stressing the 
keyboard connector. 


You should be able to 
rest the case on the 
power supply and on a 
book or two. 


. Verify that there is а 


7415151 integrated 
circuit in location A9. 
This is in the front 

тому, somewhat right of 


center. 


RE 











ST ТТМ == 
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9. 





Remove the 7415151 
at A9 and set it aside. 
Plug the DIP socket of 
the glitch stomper into 
location A9, being 
careful that the red 
and blue wires exit to 
the left rear and that 
pin number 1 is on the 
front right. 


Remove the 741502 IC 
located at A12 and set 
it aside. Plug the 
stacked 74LS02-end of 
the glitch stomper into 
this socket. Be sure the 
red and blue wires exit 
to the left rear and pin 
1 is to the front right. 


- Check the pictorial of 


Fig. 6-6 to be sure you 
have everything in the 
right place, 


. Set the cover back in 


place. Some Apples 
will have a hook at 
the right rear that goes 
into a slot in the case. 
If yours does, make 
sure the hook fits into 
the case slot. 


. Carefully hold case 


and chassis together 
and turn them back 
upside down. Do not 
let them separate. 


. Replace the ten 


Phillips screws holding 
case to chassis. 


. Replace all plug-in 


cards, cables, and 
whatever, 


. Replace cover, but 


leave the line cord 
unplugged till you 
complete checkout. 


‚ Label and store your 
"extra" integrated 
Circuits. Save these 
should a warranty 
repair be needed, 
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INSTRUCTIONS FOR BUILDING 
THE GLITCH STOMPER 


1. Cut the blue wire into two pieces, one 3% inches long and 
‘one % inch long. Strip 3/16 inch of insulation from each end. 





Do the same to the red wire. 


2. Carefully identify pin 10 of the machined-pin DIP socket. If 
you have a second 16-ріп DIP socket available, plug this 
machined-pin socket into it. This will keep the pins aligned 
should the plastic soften. Insert one end of the 334-inch blue 
wire into pin 10 of the DIP socket. Then solder this wire in 
place. 


Position the wire so that it lies flat as shown. Remove the dum- 
my socket if you used one. 


3. Carefully identify pin 10 of the 7415151 1-of-8 data selec- 
tor. Bend this pin straight out as shown. Tin this pin with a very 
-small amount of solder and, then, solder one end of the 334 
inch red wire to pin 10 of the 74LS151. 


Make sure that pin 10 does not point downward or short to ad- 
jacent pins. 


4. Plug the 7415151 into the machined-pin DIP socket, making 
sure that pin 1 of the IC goes to pin 1 of the socket. 


Route the wires as shown and temporarily set this half of the 
modification aside. 








5. Press a 74LS02 quad NOR gate into a piece of protective 
foam. Carefully tin the very tops of pins 7, 10, 12 and 14 witha 
small amount of solder. 





Make sure no solder reaches the part of the pins that must fit 
the socket. 


6. Solder one end of the 34-inch blue wire to the very top of pin 
12 of the 7415151 as shown. 





Then, solder one end of the 34-inch red wire to the very top of 
pin 10 of the TALS151. 








жон Е SHORT 

D BLUI 

Make sure there are no pin-to-pin shorts and that you can still 7 | 

plug this IC into a socket. ‘SOLDER | 
74.302 





| взопвон | 





Fig. 6-5. How to build 


Glitch Stomper 
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10 TO #11 





CONNECT 4) 
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а <= 
° 5 
" “4 ситет 
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E 2 LIKE THIS 
ВЕНОАЦ " ° 
BUT #7 AND 814 
STRAIGHT OUT 
SOLDER 
FLAT AND #7 TO #7 AND 
SQUARE нта ТО #14 
ERI TRI 















з з опа ом 





|+——LONG BLUE WIRE 
PINS #1-6 


ARE NOT 
CONNECTED 
4 














7. Take а second 741502 quad NOR gate and bend pins 1 
through 6 straight out. Then, bend pins 8 through 13 straight 
out. 


Then, cut 1/16 inch off the very ends of pins 7 and 14. Tin these 
pins with a small amount of solder on the cut ends. 


8. Piggyback the second 74LS02 quad NOR gate onto the first 
74LS02 quad NOR gate so that pins 7 and 14 of each IC contact 
each other and so that the top IC sits square and flat on the 
bottom one. 


Solder pin 7 to pin 7 and separately solder pin 14 to pin 14. 
Make sure both ICs "point" the same way and that you can still 
plug the bottom IC into a socket. 


9. On the top 74LS02, bend the tip of pin 11 so that it faces pin 
10 and bend the tip of pin 10 so that it faces pin 11. 


Solder these two pins together. 


10. Take the free end of the short blue wire coming from pin 
12 of the bottom 741502 and solder this wire to рт 9 of the 
upper 74LS02 as shown. 


Then, take the free end of the short red wire coming from pin 
10 of the bottom 741502 and solder this to wire to pin 12 of the 
upper 74LS02 as shown. 


Note that the two wires should cross each other, forming an 
"x. 


11. Take the long blue wire coming from the data selector half 
of your mod and solder this wire to pin 8 of the upper 741502, 
as shown. 


Then, take the long red wire coming from the data selector half 
of your mod and solder this to pin 13 of the upper 74LS02, as 
shown. 


12. Carefully check your glitch stomper against the schematic 
of Fig. 6-4 and the pictorial of Fig. 6-6. 


13. This completes your glitch stomper modification. See text 
for installation and checkout details. 


your glitch stomper. Е 
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lere is how to check your glitch stomper modification . 












GLITCH STOMPER 
CHECKOUT 





. Turn the Apple OFF 
and plug in the line 
cord. 


. Very briefly, turn the 
Apple on and, then, 
back off again. The pilot 
lamp should light and 
there should be only a 
single click from the 
power supply. 











- Turn the Apple on and 
hit RESET, followed by 
а few random keys. You 
should get a text 
message. 




























. Get into BASIC, and, 
then, type GR. Top of 
screen should go to 
black. Then, do а 
COLOR - 5 followed 
by a HLIN 0,25 AT 10. 
You should get a color 
line on the black 
Screen. 












. Keep typing keys and 
returns till you get down 
screen. The usual text 
should appear in the 
usual mixed graphics 
mode. 














. Type HGR. Screen 
should go black. Type 
HCOLOR - 3, and, 
then, HPLOT 0,100 TO 
100,0. You should get a 

„single diagonal line on 

^ the screen. Check for 

normal mixed text on 

the bottom. 








. Run the FUN WITH 
MIXED FIELDS demo. 

Everything should work 
with no glitches. 
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Fig. 6-6 shows yau a pictorial view of your installed glitch stomper. The 
sidebar given back in Enhancement 2 shows you how to read Apple’s compo- 
nent locations. 


(DADAPTER MADE @vumPer wines. @ricaysack РАВ oF 
FROM PREMIUM DIP MODIFY LINE “В” 741502 8 IS PLUGGED 
SOCKET AND MODIFIED TO STOMP GLITCH INTO A12 


7415151 PLUGS INTO АЗ 





ТЕГЕ 


FRONT OF APPLE || 
MAIN BOARD 


Fig. 6-6. Pictorial shows glitch stomper modification in place. 


Should you not get the pilot light to come on or should the power supply click 
more than once, STOP IMMEDIATELY. This means you have a short in the 
mod—most likely caused by an upside-down IC. If you end up stuck in text 
mode or stuck in HIRES, this means that you have a problem on the upper 
74L802—most likely caused by a short or a ріп mixup. However, any problems 
at all are very unlikely since this is a straight and simple modification. 

The glitch stomper is totally invisible except when you suddenly switch on- 
screen from LORES to text or HIRES, and should not interfere with any other 
intended use or attachment to your Apple. The additional power-supply current 
is very low, so you can leave the glitch stomper in place all the time. 

The glitch stomper is a simple enough and powerful enough modification that 
we hope Apple will add it themselves to future revisions of the Apple main рс 
board 


A complete set of all parts needed 
to make one glitch stomper 


modification is included in the 
Parts kit that is companion to this 
volume. 























Enhancement 


GENTLE SCROLL 


This simple software add-on gives 
your 48K Apple Па crawling or 
gentle scroll for easy reading of 
upward-moving text. The gentle 
scroll is compatible with the high- 
resolution character generator. 


GENTLE SCROLL 


Have you ever been infuriated by how your Apple's text jumps ир the screen 
during а normal scroll? Most personal computers and practically all video termi- 
nals share this same hangup. Yet, it is surprisingly simple and easy to add a 
protected and invisible machine-language subroutine to your 48K Apple II that 
will give you a smooth and continuous flow of your text up the screen. 

1 call this enhancement a gentle scroll, Fig. 7-1 shows us the differences 
between a gentle scroll and an abrupt, or ordinary, scroll. In your usual abrupt 
scroll, the characters move up on the screen an entire character line at a time. 
Thus, each character dot reappears eight dots above where it was before, 
making it just about impossible to read anything while scrolling. The gentle scroll 
only moves up one dot at a time, giving you the й/иѕіоп of a continuous or 
crawling text that is very easy to read. During each movement in a gentle scroll, 
the message only travels one-eighth as far up the screen. Thus, eight movements 
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In an abrupt or conventional scroll, words move up EIGHT 
dots at a time. You can not read the screen whilo 1 ia 
serong 





ntle scroll, words move slowly up the screen, ONE 
ime. You can easily read the screen while it is 
п. Eight gentle scrolls replace one abrupt scroll 





Fig. 7-1. А gentle scroll is far better looking and easier to read than a conventional оғ 
abrupt scroll. 


are needed in succession for the same displacement as one old-style abrupt 
scroll. 

You can do a gentle scroll either with hardware or software. | first tried the 
hardware route and found that elaborate changes in the Apple's system timing 
would be needed, along with other hassles. Therefore, we will be using a 

>ftware subroutine instead that works on any 48K Apple microcomputer. While 
igentle scroll is intended for use in a protected CHARACTER SET slot under 
эре’; HRCG (High-Res Character Generator), supplied with the DOS Toolkit, 
this gentle scroll will work from most any host program in almost any language. 
It should be compatible with any other character generator that uses the HIRES 
screen for display. 

More and more programmers are going the HIRES route for character display 
because of the variety of fonts that you can have, the stunning animation and 
wipe possibilities, the mixing of graphics and text anywhere on the screen, the 
wide color range and text-over-color choices, and so on. 

Note that our gentle scroll is ол/у a gentle scroll. It does not map characters 
‘onto the HIRES page for you. All the gentle scroll does is move any existing 
characters or graphics smoothly up the screen. The HRCG is an ideal host 
program to initially enter characters. The HRCG interacts with the gentle scroll 
by replacing its own incredibly ugly abrupt scroll with a subroutine call to the 
gentle scroll. While you do not have to use the HRCG, you will need some other 
host program to get the characters on the screen and to decide when a scroll 
is needed. 

We will show you a simple Applesoft test program that does not need a 
character generator. This will get you started but, later on, you will want to add 
HRCC ог something similar so as to make best use of your new gentle scroll 
capability. = 

Fig. 7-2 shows us how we do a gentle scroll. We use HIRES page One for our 
main text display. Every time we want to do a gentle scroll, the host program 
(HRCG) calls the gentle scroll subroutine. This subroutine then starts mapping 
from page One to page Two, going up one dot row. Then, we remap from page 

“о back to page One, going up a second dot row, and so on. We repeat this 

3t times, ending up back on page One with our text smoothly moved up the 
-чтееп. Only the page we are mapping from ever gets displayed on the screen, 
50 everything appears smooth and continuous. One call to the gentle scrolling 
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--------------.1-------- 


TO DO A HIRES GENTLE SCROLL 





тама 1 | ano МАР то | 2 | THEN. 








ИРУ] 2 | ano MAP TO 








цд! + | ano MAP TO | 2 | THEN 











DISPLAY| 2 | мо мар то | + | THEN, 
L 








Fig. 7-2. How a gentle scroll is done [ 
wing Pipes 1254 2. риду 1 | ано MAP TO | 2 | THEN 








общи 2 | АМОМАРТО | 1 | THEN. 





osetay| 1 |АНОМАРТО | 2 | THEN. 

















овмлү| 4 | АНОМАРТО | : | ЕМАЦУ... 


овялу| 1 


THIS SMOOTHLY MOVES EVERYTHING ONE 
CHARACTER ROW (3 DOTS) UP THE SCREEN, 





subroutine does all eight mappings needed to smoothly move up one complete 
row of characters. With the field sync modification of Enhancement 4, the 
remapping can be made totally invisible. Without this field sync mod, the results 
are still acceptable but not quite as nice. 

While а gentle scroll can be done by remapping a single HIRES page, we have 
chosen this two-page route for maximum possible speed and smoothness. 


THREE PROBLEMS 


If a gentle scroll is so fast and easy, why wasn't it available since Year One, 
and why can't you get it on most other personal computers? It turns out that 
there are three problems that interact to make a gentle scroll somewhat tricky. 
These three hassles involve the eye’s perception of motion, collisions caused by 
the raster scan, and the remapping time needed to get from one HIRES page to 
another. Let's look at these hassles one by one. . . . 


Motion perception 


This is the simplest of the problems, If you present to the eye two events that 
are separated by less than 10 milliseconds, both events will appear to exist at 
the same time. If you take over 100 milliseconds between events, then one event 
will clearly be seen to happen after the other one, and a distinct jump will be 
seen between the two. 

Itis only when you present two events faster than 10 milliseconds, or slower 
than 100 milliseconds, that the eye "fills іп” with the illusion of a smooth and 
continuous motion. Television uses а 60-field per second rate while most movies 
use a 48-field per second rate. Both these values center in the range where the 
eye best senses apparent motion. 

The exact speed range over which you can get a smooth illusion varies with 
the contrast, the image, and many other things, but this 10- to 100-millisecond 
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2a is where we have to aim if we expect to obtain any smooth and useful 
results. 

The Apple presents us with 60 fields per second. This is equal to one field of 
video every 17 milliseconds. Which tells us that a single scroll should take 
somewhere between one and six fields to accomplish an action if we are going 
to get smooth results. We will split the difference and use four fields to remap 
up one dot line. This should give us the best illusion of an apparently continuous 
motion 

Our second hassle is called . . 


Raster scan collisions 


You've seen this one before. It has ruined more than one animation attempt. 
There is “sugar,” or “collisions,” or “flicker,” or whatever in the display. Small 
objects may appear double or may momentarily reverse direction. These dis- 
tractions can range from just barely noticeable to downright annoying. 

On some personal computers, the worst of these distractions are caused by 
the CPU stealing time from the display for remapping. Fortunately, the Apple has 
a transparent display that never has to pause to let the microprocessor add bytes 
to, or remove bytes from, the display memory. Each and every machine cycle 
on the Apple gets shared 50-50 by the CPU and the display timing. Each works 
nicely in the other's unneeded and unused blind spot to gain full transparency. 

The main cause of sugar or collisions on an Apple display is that the television 
set paints a raster only one dot at a time. The top part of the raster goes down 
hefore the bottom part does. It takes 16 milliseconds to get from the top of the 

“een to the bottom, giving us some 262 horizontal lines of some 65 mi- 

Oseconds each. 

What you can get during animation is a mix of the "old" picture and the 
"new" picture if you aren't careful. This can range from “just mapped" stuff to 
old information that is as much as 17 milliseconds out of date. This "old" and 
"new" mix can momentarily give you a “wrong” display. 

Fig. 7-3 shows us how we can get a collision between two character rows if 
we try moving characters and viewing them at the same time. Most of the time, 
you either are presenting "old" or “new” information. But, every once іп a 
while, a character will get moved during the time it takes to get from one 
horizontal line to the next. When this happens on a blank line between charac- 
ters, the new" or "lower" character crashes into the “old” or “upper” charac- 
ter without any space between. The result is a brief flash that really can look bad. 

You can also get the opposite effect in which a dot line is dropped out. Instead 
of a flash, you get an “unflash” in which the middle of an E," an “H,” an "S," 
or whatever disappears momentarily, leaving you with a strange bunch of illegi- 
ble dots. 

This is sort of like a small town that has one cop and one thief, each of whom 
are making their rounds. Eventually, they are bound to run into each other even 
if they are traveling at different speeds and are using different paths going 
through town. xt 

All of which tells us we should never display the HIRES page you are moving 
characters to. While you can do a gentle scroll using a. single page of video and 
remapping things one line at a time, you will find the collisions to be annoying 
and the motion slightly nervous ог erratic. Тһе “one-page” program that | tried 

“ned out to be longer than the available space in one HRCG character set and 

iis a second disadvantage. You will get the best results by using two HIRES 

4ges for a scroll, displaying one while you move dots to the new location on 
the other. 
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Fora gentle scroll, both НІНЕ pages are used alternately to 
eliminate the "sugar," “Sparkie,” or "collisions" caused 
by raster scan problems. These effects usually last one 
Не апа can become very annoying. 





Most of me times, а HIRES map-while-displaying-the- 
same page woud lock. 





As the raster scan works its way нот top to bottom, И wil 
Overrun the mapping every now and then, leading 10 
results 





Sugar and collision Назнев can be completely eliminated 
by displaying one HIRES page while you are remapping 10 
the second and, aiso, by switching between HIRES pages 
‘only during the vertical blanking time. 


Fig. 7-3, Raster scan collisions. 


Even if you switch between the pages after mapping is complete, you can still 
get a brief flash or collision every now and then. This happens if you decide (о 
Switch between pages in the middle of a live scan. Our field sync hardware 
modification eliminates this final and fairly minor hassle. 

We use a program similar to the CRUDE program of Enhancement 4 to make 
sure we only flip display pages during the vertical blanking time. This way, only 
“whole” pages appear on the screen and you get no collisions. This particular 
use of field sync is far less critical than the exact locking needed for mixed fields 
or other super fancy stuff. 

To review, when the field sync modification is in place, we can do a simple 
bit test of SW3 that waits till it is “safe” to flip from one screen to the other. 
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е machine-language bit test of location $C060 sets the negative flag if it is safe 
«J switch the pages and clears the negative flag if it is not. By BPL branching to 
retest till it is safe, you can always be sure that you will avoid all collisions and 
all sugar. 

What's that location in decimal for use in a BASIC program, you ask? You've 
got to be kidding. Your Apple warranty isn't long enough to let you do a gentle 
scroll in BASIC. In fact, unless you are really into machine language, even 
machine language will seem far too slow. So what you do is provide a special 
and exceptionally fast machine-language subroutine and call it from any host 
program in any language you like. 

This brings us to the third hassle of . . . 


Mapping time 


The real sticky problem is that it takes a long time to move all those dots from 
one HIRES page to a different position on the other one. Let's see. There are 192 
rows of 280 dots each for a total of 53,760 dots. We can move these dots seven 
ata time with a single machine-language byte, so only 7680 moves are needed. 
But wait. That is 7680 moves to go up a single dot row. We have to go eight 
dot rows to move up one full character—for a total of 61,440 mappings. 

Now, if you use machine language the way most people do, this remapping 
will take far too long. The usual way we might map is to use the indirect indexed 
command such as is done in the abrupt scroll included in the HRCG. The code 
could look something like this . . . 





REMAP LDA (P1LOC),X ; Get a byte from page 1 
STA (P2LOC),X ; Move it to page 2 
DEY ; Go to next byte 
BNE REMAP ; And repeat till done 


This says to go to the sum of the address in P1LOC plus the value in the X 
register, and put whatever you get from there in the sum of the address in P2LOC 
plus X. Both PILOC and P2LOC will be pairs of page Zero addresses that point 
to the base address at the left end on any line. Keep doing this remapping till 
X hits zero. You start at the right end of one line and work your way to the left, 
remapping as you go along. The code is short, simple, very powerful, and 
disgustingly elegant. 

It also works. Sort of. If you have the time. 

The trouble is that this obvious route is far too slow. Let's add things up. We'll 
assume an Apple machine cycle takes exactly 1 microsecond. If you area timing 
purist, just multiply all that follows by 0.978. An indirect load takes 5 mi- 
croseconds. An indirect store takes 6. Add 2 microseconds to knock one count 
off X, and a final 3 microseconds to go back and repeat. A total of 16 mi- 
croseconds, or just a tad under 16 if you are really keeping score. 

Using 16 microseconds to move seven somethings sounds pretty snappy till 
you realize that we have 61,440 mappings to do. Multiplying 61,440 mappings 
times 16 microseconds per mapping equals 0.983 second, 

We can apparently scroll а row of characters smoothly up eight dots in slightly 
under a second. This doesn't sound too bad until you realize that there are 24 
lines of text on the screen, so it takes nearly 24 seconds to get from the bottom 
"the screen to the top. This can turn out to be unacceptably slow for some uses. 

What can we do to speed up a tight, sophisticated, and elegant little remap- 
лғ loop like the one we just looked at? 

Scrap it. 
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That's right, scrap our compact and elegant code. Indirect indexed modo 
dramatically shorten the physical length of a program all right, but they take 
longer to execute. And loops a/ways add overhead, since you always have to 
decrement something and, then, branch to get out of a loop. Even an “етріу” 
loop that does nothing uses up 5 microseconds not doing whatever it is that it 
is not doing. 

The fastest possible code that you could write would use the fastest address 
mode and no loops. We could write a program that would absolutely load and, 
then, absolutely store each and every location and it would be much faster. 
“Brute Югсе” coding of this type would only need 8 microseconds per mapping. 
Compare this to the 16 microseconds that the elegant code demands 

But, this brute force route would have the disadvantage of needing more than 
46,000 bytes of code! And, that’s for a single mapping. You have to double that 
to get back to the first page. Some compromise is obviously needed between 
code that is short and elegant and code that is. long enough to rapidly do the 
job. 

We first notice that absolute indexed addressing is fairly snappy at 4 mi- 
croseconds per load and 5 microseconds per store. And, we can now use а loop 
to shorten the code by bunches. But, there’s that loop again. The sneaky and 
crucial trick is to share the loop as many ways as possible. If 32 mappings are 
done inside a loop, the loop overhead of 5 microseconds only takes 5/32 of a 
microsecond per mapping. Our code might look like this . . . 


REMAP LDA 32400,Х 2 Move first byte 
STA 54000,Х 
LDA $2800,X ; Move second byte 
STA 54400,Х 
ША 52С00,Х ; Move third byte 
STA $4800,X 


; (repeat 32 times) 





LDA $3F00,X ; Move thirty-second byte 
STA 55800,Х 

рЕХ ; move one to left 

BNE REMAP ; and repeat till done 


This code is obviously much longer than the earlier code. But look at the 
timing. Four microseconds to load, five to store, and a mere 5/32 of a mi- 
crosecond as one mapping's share of the loop overhead. Our total is slightly over 
nine microseconds, or around one-halí the total of using the "elegant and 
compact” code of the HRCG. 

Note that this new code also maps in a different sequence. The usual code 
works from right to left, one horizontal dot row at a time. Our fast code starts 
with part of a rightmost column of dots and then works its way from right to left 
doing a partial column at a time. 

The actual mapping details turn out even messier than this, as we will see. The 
important points here are that an oddball mapping sequence (1) is very fast, and 
(2) doesn’t matter anyway since you don’t look at the page till after the mapping 
is completed. What we are after here is a fast final result, and that is just what 
we get. 
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The gentle scroll program turns ош fairly long since we are using less elegant 
addressing modes. The entire program is only 600 bytes long, and fits a protect- 
ed slot originally intended for use by an alternate character set under HRCG. 

When you use the gentle scroll, the measured time on screen is something like 
12 seconds from bottom to top. The first time you see this, you will say that it 
is far too slow. And, if you are listing a program, а gentle scroll may indeed take 
a minute to list a 100-line program. 

Let's look at this 12 seconds in a different light. If we completely fill the screen, 
we'll average 7 words or so per line. And, 7 words per line times 24 lines equals 
168 words in 12 seconds, or a reading speed of 840 words per minute. 

This is at least four times faster than most people can read. When you actually 
use the gentle scroll in your programs, your messages will usually be short. What 
at first sounds like an awfully slow scroll time actually turns out to be a very 
useful and attractive speed. 

The fast remapping code will take 4 fields to scroll upwards by a single dot, 
which translates to 32 fields being required in order to do a complete 8-dot 
full-character scroll. Thus, slightly over half a second is needed for each full- 
character scrolling. 


MEMORY МАР 


A memory map of a 48K Apple II, using the gentle scroll under HRCG, is 
shown in Fig. 7-4. We've already seen back in Enhancement 3 how the bottom 
2K-bytes of RAM from $0000 through $07FF are reserved for system use. 
Review the details on this and you will find reference locations on page Zero 
‘of memory, the stack on page One, the keyboard buffer on page Two, DOS 
hooks on page Three, and “page One" of text and low-resolution graphics on 
memory pages Four through Seven. Here a memory “page” consists of 256 
locations, while а video “page” is made up of whatever happens to fit the 
screen. One 1024-byte text or LORES page needs four RAM memory pages of 
256 bytes each. 

Looking further up the map, we see that HIRES page One fits in locations 
$2000 through $3FFF, and HIRES page Two resides at hex $4000 through 
$5FFF. Each HIRES page needs 8K of RAM to store its image. Thus, thirty-two 
pages of RAM memory will always be needed for each HIRES page. 

DOS normally resides at the top of RAM, and goes from locations $9600 up 
through $BFFF. The HRCG high-resolution character generator and its alternate 
character sets reside just under DOS 

The HRCG is an example of a new type of program that uses ап “R” disk file. 
The "R" stands for relocatable, and this coding must be handled differently from 
the usual “A,” “B,” "I," or "T" files you already know. When you use the 
LOADHRCG program off the DOS Toolkit, the HRCG is automatically put just 
below DOS and, then, enough space is cleared below HRCG for as many 
alternate fonts as are needed. After enough room is set aside and the fonts are 
loaded, the Applesoft HIMEM pointer is then automatically moved down. This 
will protect the HRCG and any of the alternate character sets from intrusion. 

This nicely eliminates the problem of making room for machine-language 
sequences with Applesoft. Just put your sequence in the space intended for the 
highest HRCG alternate character set, and the routine gets put out of harm's 
way. Everything is set aside for you automatically without any calculations or 
sneaky tricks. 

You'll find two areas left in the memory map for your Applesoft or other 
program. The 6K space from $800 through $2000 is available, as are the 10K + 
locations $6000 through $8AFE. 
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HEX DECIMAL 


GENTLE SCROLL SUBROUTINE, 
PROTECTED UNDER HRCG 


10K + SPACE AVAILABLE 
FOR APPLESOFT STRINGS 
AND VARIABLES. 


ВК SPACE AVAILABLE 
FOR APPLESOFT 
PROGRAM LINES 





Fig. 7-4. Memory map of 48K RAM under gentle scroll. Most shorter Applesoft 
programs will fit as is. Longer ones may need pointer adjustment, 
disk reaccess, or other memory management. 


Applesoft normally builds its program up from its TXTAB pointer at the lowest 
available RAM location. This is usually $0800. It also builds its variables down 
from HIMEM. You will usually have around 6K of program space and some 10K 
of variable space available till you bump into either HIRES page. 

Most shorter Applesoft programs will fit as is. Longer ones may need pointer 
adjustment, disk reaccess, REM elimination, or other memory management 
tricks. Note that this is nearly the same problem that you have any time you want 
to use both HIRES pages and Applesoft. The HRCG and its alternate fonts take 
up little extra room. 

Our gentle scroll program should get loaded as the highest character set under 
the HRCG. But, we will never use this set as a character set. Instead, we will 
find the magic hooks to jump to this code subroutine every time the HRCG 
wants to do a scroll. The reason we use a character set location is for the 
Convenience it gives us in automatically loading a machine-language program 
into a protected space. On a 48K Apple computer operating under DOS 3.3, 
the highest character set lies from $8AFF through $8CFE. If you do use any 
alternate character sets, they will automatically be placed lower in memory. 
Regardless of how many alternate fonts you use, the highest character set will 
always start at $8AFF, Should you use alternate character sets, each additional 
character set will need another 3 pages, working down through memory. 

Thus, the highest alternate font will always lie from $8AFF to $8DFF, and the 
lowest alternate font will always have the lowest starting address, regardless of 
how many fonts you use. All of these will, reside іп a protected space above 
HIMEM. 
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We now know where to put our gentle scroll machine-language program and 
how to get it there. One big location problem that remains is figuring out what 
maps where on HIRES page One and page Two. 

The first time you look at HIRES locations, they may seem random or sense- 
less. In fact, they were very carefully chosen to greatly simplify the hardware 
needed in the Apple's video timing circuitry. 

Fig. 7-5 shows us a typical HIRES horizontal line. Each line begins with a BASE 
address on the left and needs 40 bytes. The bytes are numbered left to right as 
BASE, BASE+1, BASE+2, . . . , and so on, up through ВА5Е--39 in decimal, 
or BASE+$27 in hex, at the extreme right. 

Each byte, in turn, holds seven dots. These dots are arranged "backwards" 
as the lower seven bits. The LSB is the /eftmost dot. The eighth or MSB is not 
mapped. Instead, it is used as an optional half-dot shifter that gives us color 
changes by shifting all seven dots simultaneously. 

As an example, if some line has a base address of $2400, the leftmost seven 
dots will be in location $2400, the next seven in $2401, the next seven in $2402, 
and so on across the line to the final seven dots contained in $2427. 

What gets sticky fast is finding the base address for each horizontal line. There 
are elegant program sequences in the HIRES subroutines that let you calculate 
each and every base address as needed. But these calculations take quite a bit 
of time and they must be avoided at all costs if you want the fastest possible 
code. 

Rather than calculate base addresses, we will simply call them out as they are 
needed in the code. This is much faster. Table 7-1 is a table of the base addresses 

f each line. This is shown as a decimal or hex scan line number and as a 
which-dot-row-of-which-character" number pair. 

The base addresses are rearranged for you in Fig. 7-6. Here we see the packing 
of lines into each sequential 256-byte page of memory. These addresses are all 
shown for HIRES page One on the left and HIRES page Two on the right. To find 
à comparable address for Hires page Two, just add hex $2000 to each page One 
location. To go the other way, subtract hex $2000. 

Now, if we were trying to display and remap on the same page at the same 
time, we would have to start at the top of the display and remap each line one 
place up from where it happened to be. This would take 192 separate remap- 
pings since there are 192 vertical lines (24 characters x 8 dots per character) 


LEFTMOST ВУТЕОМ BASE ADDRESS BASE ADDRESS RIGHTMOST BYTE ON 
THE LINE IS THE PLUS ONE PLUS TWO THE LINE IS ТНЕ 
BASE ADDRESS BASE ADDRESS PLUS. 


DECIMAL 39 OR HEX $27 








——— 
EACH HIRES BYTE HOLDS 
SEVEN DOTS, ARRANGED 
"BACKWARDS" IN THE. 





= DATA WORD. . . 
THERE ARE 40 BYTES. i RIGHTMOST LEFTMOST 

OF 7 DOTS EACH USED por por 

FOR EACH HORIZONTAL, + + 

ROW OF 280 DOTS 

THERE ARE 192 HIRES 

LINES PER PAGE. EACH © » а и = а а а 


INE HAS ITS OWN BASE 


EIGHTH BIT CONTROLS SHIFT OF ALL 7 DOTS 
М DOT TO THE RIGHT FOR COLOR CHANGE 





-5. Details of one horizontal line mapping. 
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$3800 6 | 70 | 134 14 | 78 | 142 № $5800 
$3900 22 | 86 | 150 30 | за | 158 № 55900 
$3A00 38 | 102 | 166 46 | 110 | 174 Ё $5400 
53800 54 118 | 182 62 126 | 190 55800 
53С00 7 71 135 15 79 143 55С00 
53000 23 87 151 31 95 159 $5000 
53Е00 39 103 | 167 47 111 175 $5E00 
53Ғ00 55 119 | 183 63 127 | 191 55Ғ00 





1 1 1 pee =) 1 ! 
500 $28 550 $80 ЗАВ 500 ЗЕЕ 
EACH BLOCK SHOWS HORIZONTAL LINE NUMBER 
IN DECIMAL, {= UNUSED 8 BYTES OF RAM. 


Fig. 7-6. How HIRES lines are packed into memory. 


in the display. We would map line 1 to line 0, then line 2 to line 1, and so on 
down the screen. : 

But, a two-page mapping lets us get sneaky and greatly shorten the code. An 
indexed move lets us mave up to 256 bytes from one base address. Do things 
just right and we can be remapping six lines using the same indexed move 
instruction. This shortens the code bunches. For instance, one indexed mapping 
Code pair can map lines 1 to 0, 65 to 64, 129 to 128, 9 to 8, 73 to 72, and 137 
to 136. All of this is done with the same base address of hex $2400. You first 
set your X index pointer to $F7 and work your way down the list. First, you 
remap all of line 137, then ай of line 73, then ай of line 9. Then, you reset your 


a ы 
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Table 7-1. HIRES BASE ADDRESSES 




















LINE NUMBER РАСЕТ BASE PAGE 2 BASE 
DECIMAL CHAR/DOT НЕХ DECIMAL HEX DECIMAL HEX 
! 
0 оо $00 8192 52000 16384 $4000 Е | 
1 ол 501 9216 $2400 17408 $4400 | 
2 o2 $02 10240 $2800 18432 $4800 
3 оз 503 11264 $2C00 19456 %4С00 
4 04 504 12288 53000 20480 55000 
5 05 505 13312 — $3400 21504 55400 
6 06 506 14336 53800 22528 55800 
7 07 507 19360 $3000 235529 %5С00 
в vo $08 8320 52080 16512 $4080 
9 1n $09 9344 5240 17536 $4480 | 
10 12 $0 10368 52880 18560 54880 
и 13 508. 11392 52080 19584 54С80 
12 та soc 12416 $3080 20608 55060 
13 vs $0D 13440 $3480 216324 55480 
14 Mt SOE 14464 53880 22656 $5880 
15 17 SOF 15488 5300 23680 55С80 
16 20 $10 8448 52100 16640 $4100 
17 2л su 9472 52500 17664 54500 
18 22 $12 10496 $2900 18688 $4900 
19 23 513 11520 %2000 1972 $4000 
20 24 514 12544 — $3100 20736 55100 
21 25 515 13568 $3500 21750 55500 
22 6 $16 14592 53900 2174 55900 
23 27 517 15616 53000 23808 55000 
24 зю $18 8576 $2180 16768 54180 
25 зл 519 9600 52580 17792 $4580 
26 32 SIA 10624 $2980 18816 $4980 
27 33 $18 11648 $2080 19840 $4080 
28 34 яс 12672 $3180 20864 55180 
29 35 яр 136% 53580 21888 55580 
30 36 ЗЕ 14720 53980 22912 55980 
31 37 $1F 15744 $3080 2396 $5080 
з2 40 520 8704 — $2200 16896 $4200 
3 ал 521 9728 52600 17920 %4600 
34 42 522 10752 %2400 18944  $4A00 
35 4n 523 11776 $2t00 19968 54600 
36 44 524 12800 $3200 2099209 55200 
37 45 525 13824 $3600 22016 55600 
38 46 526 14848 $3A00 23040 55А00 
39 47 527 15872 53Ю0 24064 55Е00 
40 50 528 8832 52280 17024 54280 
5 5/1 $29 9856 52680 18048 54680 
42 52 32А 10880 52А80 19077 %4А80 
43 53 528 11904 $280 20096 | $480 
44 sa $2c 12928 $3280 21120 5520 
45 55 $20 13952 $3680 22144 35680 
46 56 02228 14976 53880 23168 55380 
47 57 т ЗЕ 16000 53880 24192 $5880 
48 6/0 $30 8960 $2300 17152 54300 
49 өл $31 9984 $2700 18176 54700 
50 62 $32 11008 — $2800 19200 54800 
51 63 $33 12032 520 20224 5400 « 
52 6/4 $34 13056 $3300 — 21248 55300 
53 65 535 14080 53700 22272 55700 
54 66 536 15104 53800 232956 55800 
55 67 537 16128 $3200 24320 5500 
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Table 7-1 Cont. HIRES BASE ADDRESSES 





LINE NUMBER PAGE 1 BASE PAGE 2 BASE 
DECIMAL CHAR/DOT — HEX DECIMAL НЕХ DECIMAL НЕХ 














56 2 538. 9088 52380 17280 54380 
57 7A $39 1012 $2780 18304 $4780 
58 7n ЗА 11136 $2880 79328 $4880 
59 73 538 12160 52580 20352 54880 
60 74 53С 13184 $3380 21376 55380 
61 75 530 14208 53780 22400 $5780 
62 76 ЗЕ 15232 53880 23424 55800 
63 77 $3F 16256 $3Р80 24448 %5Ғ0 
64 80 540 8232 $2028 16424 84028 
65 ал $41 9256 $2428 17448 54426 
66 an $42 10280 $2828 18472 54828 
67 83 343 11304 — $2028 19496 $4028 
68 84 $44 12328 $3028 20520 $5028 
69 8/5 $45 13352 — $3428 21544 55428 
70 8/6 $46 14376 $3828 22568 55828 
n 87 $47 15400 53С28 23592 55С28 
72 9/0 $48 8360 $20А8 16552 54048 
73 эл $49 3384 $24A8 17576 —— $4448 
74 92 А 10408 52838 18600 $4848 
75 93 $48 11432 — $2CA8 19624 %4САВ 
76 9A $4C 12456 $3048 20648 $5048 
7 95 540 1340 534А8 21672 — 854АВ 
78 9/6 54Е 14504 538А8 22696 558А8 
79 97 $4F 15528 $3CAB 23720 55САВ 
80 100 550 8488 $2028 16680 $4128 
ат 101 $51 9512 %2518 17704 54528 
82 102 552 10536 52928 18728 $4928 
83 103 553 11560 52028 19752 $4D28 
84 104 554 12584 53128 20776 $5128 
85 105 555 13608 $3528 21800 55528 
86 106 556 14632 53928 22824 55928 
87 107 557 15656 53028 23848 $5028 
88 110 558 8616 — $2148 16808 $41A8 
89 ил 559 9640 52548 17832 %45А8 
9 112 554 10664 52848 18856 $49А8 
91 ША 558 11688 420АВ 19880  $1DAB 
92 11/4 55С 12712 — $3148 20904 $5148 
93 115 $50 13736 535А8 21928 55548 
94 1/6 35Е 14760 $39АВ 22952 $5948 
% nz $5F 15784 — $3DAB 23976 $50АВ 
96 120 560 8744 52228 16936 34228 
97 12A $61 9768 52628 17960 54628 
98 122 562 10792 — $2428 18984 $4A28 
99 128 $63 11816 — $2228 20000 — $4E28 
100 124 $64 12840 $3228 21032 — $5228 
101 12/5 $65 13864 53628 22056 55628 
102 12/6 $66 14888 %3А28 23080 - %5А28 
103 127 567 15912 83Е28 24104 — $5628 
104 130 $68 8872 — 522А8 17064 $42АВ 
105 nn $69 9896 %26А8 18088 $46АВ 
106 132 $6A 10920 %2ЛА8 1912: $4AAB 
107 13/3 568 11944 $2EA8 20136 $4 АВ 
108 134 56С 12968 532А8 21160 552А8. 
109 13/5 560 13992 536А8 22184 456А8 
110 136 56Е 15016 5ЗААВ — 23208 ААВ 


"m 137 56Р 16040 :$3EAB 242320 $5tAB 
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Table 7-1 Cont. HIRES BASE ADDRESSES 
LINENUMBER РАСЕТ BASE РАСЁ2ВАЅЕ 
DECIMAL СНАКООТ — НЕХ DECIMAL — HEX DECIMAL НЕХ 
12 14/0 $70 9000 52328 17192 $4326 
113 тал $n 10024 $2728 18216 $4728 
14 142 572 11048 $2828 19240 $4828 
115 143 523 12072 5228 20264 $4F28 
116 14/4 $74 13096 $3328 21288 55328 
nz 145 575 14120 $328 2242 55728 
118 14/6 $76 15144 53828 23336 55828 
119 147 577 16168 $3228. 24360 55:28 
120 150 578 9128 823А8 17320 $43АВ 
121 15/1 $79 10152 $2748 18344 547А8 
122 15/2 $7^ 11176 528А8 19368 $4BAB 
123 153 $78 122000 $2FAB 20399 $4FAB 
124 154 Ds 13224 $348 — 21416 $538 
125 15/5 $7D 14248 $3748 22440 $57A8 
126 15/6 57Е 15272 538А8 23464 $5ВАВ 
127 157 576 16296 ЗАВ 24488 $SFAB 
128 160 580 8272 52050 16464 $4050 
129 161 581 9296 2450 17488 $4450 
130 16/2 582 10320 $2850 18512 $4850 
131 163 583 11344 $2650 — 19536 54С50 
132 164 584 12368 53050 2050 55050 
133 165 585 13392 53450 21584 55450 
134 16/6 586 14416 53850 22608 55850 
135 167 587 15440 53С50 23632 $5C50 
136 170 388 8400 52000 16592 $4000 
137 17 589 9424 52400 17616 54400 
138 172 58А 10448 52800 18640. $4800. 
139 17/3 588 11472 52С00 19664 $4CDO 
140 17/4 58С 12496 53000 20688 %5000 
141 175 $80 13520 $3400 21712 $5400 
142 176 $8Е 14544 53800 22736 55800 
143 177 зағ 15568 $3000 2370 55С00 
14 18/0 590 8528 82150 16720 54150 
145 18/1 $91 9552 $2550 17744 54550 
146 18/2 592 10576 52950 18768 54950 
147 18/3 593 11600 52050 19792 54050 
148 18/4 $94 12624 83150 20816 55150 
149 18/5 $95 13648 $3550 21840 $5550 
150 18/6 596 14672 $3950 22864 55950 
151 18/7 597 15696 83050 23888 55050 
152 19/0 $98 8656 $21D0 16848 $41DO 
153 191 599 9680 82500 17872 $4500 
154 19/2 З9А 10704 52900 18896 $4900 
155 193 598 11728 $2000 19920 34000 
156 194 59С 12752 $3100 20944 55100 
157 19/5 . $90 13776 $35D0 21968 $5500 
158 19/6 57 $9E 14800 $39D0 22992 55900 
159 19/7 $92 15824 $3000 24016 $5000 
160 200 зло 8784 52250 16976 $4250 
161 201 ЗАТ 9808 $2650 18000 84650 
162 202 $A2 10832 $2A50 19024 $4A50 
163 203 $АЗ 11856 52550 20048 54550 
164 204 $^4 12880 $3250 21072 $5250 
165 205 555 13904 53650 22096, 55650 
168 206 $46 14928 %ЗА50 23120 55А50 
167 207 $47 15952 $3t50 24144 55550 
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Table 7-1 Cont. HIRES BASE ADDRESSES 








LINENUMBER PAGE 1BASE PAGE2 BASE 
DECIMAL CHAR/DOT HEX DECIMAL HEX DECIMAL HEX 
168 2v0 $A8 8912 522000 17104 $4200 
169 nn $49 9936 $26D0 18128 $46D0 
170 21/2 SAA 10960 $2ADO 19152 $4ADO. 
171 23 SAB 11984 52Е00 20176  $4EDO 
172 2/4 ЯС 13008: 53200 21200 $5200 
173 215 ЗАО 14032 53600 22224 55600 
174 216 SAE 15056 — $3ADO 23248 $5ADO 
175 217 SAF 16080 $3Е00 24272 55ЕО0 
176. 220 580 9040 52350 17232 84350 
177 221 581 10064 $2750 18256 $4750 
178 222 582 11088 $2850 19280 $4B50 
179 223 583 12112 52550 20304 $4750 
180 224 584 13136 53350 21328 55350 
181 125 585 14160 53750 22352 55750 
182 22/ 586 15184. $3850 23376 $5850 
183 227 587 16208 33550 24400 55550 
184 130 388 9168 52300 17360 54300 
185 231 $89 10192 52700 18384 84700 
186 13/2 $BA 11216 $2800 19408 $4800 
187 133 388 1240 $200 20432 %4Ғ00 
188 234 (вс 13264 $3300 214568 55300 
189 23/5 $BD 14288 53700 22480 55709 
190 236 $8E 15312 $3800 23504 55800 
191 237 $8F 16335 $3FDO 24528 $5FDO 








X index to hex $77 and work down all of line 129, followed by all of line 65 
and, finally, all of line 1. Trace this action out on Fig. 7-6 to make sure you see 
and understand exactly what is happening. 

However, remapping several lines with the same code does give you several 
minor hassles that you have to get around. Those unused locations from $78 
through $7F and $F8 through $FF on any page must be bypassed during the 
mapping. Besides making the code take longer, a glitch or two will remain on 
the screen if you do not carefully bypass all unused locations. 

As an aside, note that these unused locations are usually plowed anytime you 
clear the HIRES screen. Thus, while these “ее” locations are just sitting there, 
you can't safely use them for anything. This is in contrast to the 64 bytes hidden 
оп the page 1 text and LOREST screen which are used for 1/О and are very 
carefully protected during a screen clear. 

There are also a few lines that do not remap exactly in the way you might 
expect them to. These lines must each be "custom" mapped because they cause 
a move from column to column in Fig. 7-6. Five of the special cases are 64 to 
63, 128 to 127, 8 to 7, 72 to 71, and 136 to 135. There is a sixth special case 
of 0 to nowhere, but since nowhere is off screen, we can ignore this mapping. 
Again, check into Fig. 7-6 to find out why these five mappings are special. 


PROGRAM AND FLOWCHART 


A flowchart of the gentle scroll program is shown in Fig. 7-7, while Program 
7-1 gives you an assembler listing of the GENTLE SCROLL.SET program. Fig. 7-8 
shows a hex dump of the GENTLE SCROLL.SET. Details for copying and using 
the GENTLE SCROLL.SET program follow: 
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Fig. 7-7. Flowchart of GENTLE SCROLL SET. Machine-language subroutine is called 
Whenever an 8-dot gentle scroll of HIRES раве 1 is wanted. 


We begin by saving all registers and, then, 


never mapped. We ignore these by 
Чех value of $F7 and working down. Unused locations $78 
through $7F are bypassed with a compare and fix. Should we get to an index 
value of $7F, this value is immediately changed to $77, thus bypassing these 
ised locations. 
the bulk of the mapping is done six lines at a time, handling a total of 31 х 
© = 186 lines. 
After the bulk of the mapping is complete, we then custom handle the five 
special cases. These get remapped individually, 
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PROGRAM 7-1 


GENTLE SCROLL SET 














LANGUAGE: APPLE ASSEMBLER 


ЗАРЕ: 
ЗАРЕ: 
BAFF: 
BAFF: 
ЗАЕЕ: 
ЗАРЕ: 
ЗАРЕ: 
ВАЕЕ: 
ЗАРР: 
BAFF: 
ЗАРЕ: 
ЗАРЕ: 
BAFF: 
BAFF: 
ЗАРЕ: 
ЗАРЕ: 
ЗАЕЕ: 


ЗАРЕ: 
ВАЕЕ: 
ЗАРЕ: 


ЗАРЕ: 
ЗАРЕ: 
ЗАРР: 


ЗАРЕ: 
ЗАРЕ: 
ЗАРЕ: 


ЗАРЕ: 


ЗАЕЕ: 
ВАЕЕ: 
ЗАЕЕ: 
ЗАРЕ: 
ЗАРЕ: 


SAFF: 
SAFF: 


NEEDS: HIRES SUPPORT PROGRAM 
SUCH AS HRCG 
HIMEM < 35583 


IIIT IO IG e 


GENTLE 
SCROLL.SET 


VERSION 3.1 
( 3-18-81) 


BY DON LANCASTER 


Y 
AND SYNERGETICS 


* * 
* * 
* * 
* * 
* * 
* * 
* * 
1 COPYRIGHT 1981 + 
* 

* * 
* * 
* * 
* ALL COMMERCIAL * 
* RIGHTS RESERVED * 
* * 
* * 


FOI GGG Ee 


THIS PROGRAM CREATES A PAGE 


ONE GENTLE SCROLL UNDER HRCG 
FOR USE ON 48K APPLE ІІ. 


ІТ LOADS AS THE HIGHEST CHARACTER 
SET AND USES HIRES PAGE TWO 
FOR A WORKSPACE. 


А VSYNC HARDWARE MOD CONNECTING 
4/С14 TO 4/Н14 IS RECOMMENDED 
FOR BEST OPERATION. 


ТР YOU ARE NOT USING HRCG -- 


A MACHINE JSR $8AFF -OR- 
AN INTEGER CALL -29953 -OR- 
AN APPLESOFT CALL 35583 
GIVES YOU AN EIGHT SCAN LINE 
GENTLE SCROLL ON HIRES l 


PROTECT THIS SPACE WITH 
AN APPLESOFT HIMEM:35582. 
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46; IF YOU ARE USING HRCG AND 

471 MACHINE LANGUAGE -- 

49; GENTLE SCROLL ON -- 00 88 
50; GENTLE SCROLL OFF - 21 92 
52 ; IF YOU ARE USING HRCG AND 

53 3 APPLESOFT -- 

55 x GENTLE SCROLL ON -- POKE 37396,0 
56 ; AND -- POKE 37397,139 
58.5, GENTLE SCROLL OFF - POKE 37396,33 
59 ; AND -- POKE 37397,146 
60: РОКЕ ONLY АТ ТОР 

617: ОЕ SCREEN! 
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PROGRAM 7-1, CONT’D... 


BAFF: 


ЕЕЗЕ: 
ЕЕ4А: 
C054: 
C055: 
сово: 


ЗАРЕ: 


ЗАРЕ:ЕА 
8B00:20 


8B03:A0 
8B05:20 
8В08:8Е 


8B0B:A2 
8вор:вр 
8B10:9D 
8B13:BD 
8В16:9р 
8B19:BD 
8в1с:9р 
BBlF:BD 
8B22:9D 
8825:80 
8B28:9D 
BB2B:BD 
8B2E:9D 
8B31:BD 
8B34:9D 


8B37:BD 
8B3A:9D 
8B3D:BD 
8B40:9D 
8B43:BD 
8B46:9D 


BB55:BD 
8B58:9D 
8B5B:BD 
8В5Е:9р 
8B61:BD 
8B64:9D 





65 


67 
68 
69 
70 
71 


IOREST 
IOSAVE 


PAGEl 
PAGE2 
VSYNC 


NXODD 


EQU 
EQU 
EQU 
EQU 
EQU 


dade 


NOP 


**** HOOKS **** 


ЗЕРЗР 
SPF4A 
3с054 
80055 


$с060 


4/С14 VIA 4/Н14 SYNC MOD 


MAIN PROGRAM ****** 


ТОЗАУЕ 


#904 
SYNC 
РАСЕІ 


#SF7 

52400,х 
$4000,X 
$2800,X 
$4400,X 
$2C00,X 
$4800,X 
53000,х 
$4C00,X 
53400,х 
$5000,X 
53800,Х 
$5400,X 
$3C00,X 
$5800,X 


$2100,X 
$5C80,X 
$2500,X 
$4100,X 
$2900,X 
$4500,X 
52000,Х 
54900,Х 
83100,Х 
$4D00,X 
$3500,X 
55100,Х 
$3900,X 
$5500,X 
$3D00,X 
$5900,X 


ADJUST RELOCATE START 
SAVE ALL REGISTERS 


FOR FOUR PAIRS OF MAPPINGS 
OPTIONAL LOCK TO VBLANK 
DISPLAY PAGE ONE 


BYPASS UNMAPPED BITS 
LINES 1-65-129-9-... 


LINES 16-80-144-24-... 
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=== =) 
! 
| PROGRAM 7-1, CONT'D... . 
00 22 115 LDA $2200,X : LINES 32-96-160-40-.. 
80 5D 116 STA $5D80,X 
! 00 26 117 LDA $2600,X 
00 42 118 STA $4200,x 
00 2A 119 LDA $2A00,X 
00 46 120 STA $4600,x 
00 2Е 121 LDA $2E00,X | 
00 4А 122 STA $4А00,Х 
8B7F:BD 00 32 123 LDA $3200,X 
8В82:90 00 4E 124 STA 54Е00,Х 
8885:80 00 36 125 LDA 53600,Х 
BB88:9D 00 52 126 STA $5200,X 
8B8B:BD 00 ЗА 127 LDA $3A00,X 
8B8E:9D 00 56 128 STA $5600,X 
8B91:BD 00 3Е 129 LDA $3Е00,Х 
8894:90 00 5A 130 STA $5A00,X 
8B97:BD 00 23 132 LDA 82300,Х  ; LINES 48-112-176-56-... 
8B9A:9D 80 5E 133 STA $5Е80,Х 
8B9D:BD 00 27 134 LDA $2700,X 
8BA0:9D 00 43 135 STA 54300,Х 
8BA3:BD 00 2B 136 LDA $2B00,X 
8BA6:9D 00 47 137 STA $4700,X 
8BA9:BD 00 2F 138 LDA $2F00,X 
8BAC:9D 00 4B 139 STA $4B00,X 
8ВАР:80 00 33 140 LDA $3300,X 
8ВВ2:90 00 АР 141 STA $4F00,X 
8BB5:BD 00 37 142 LDA 53700,Х 
8вв8:90 00 53 143 STA $5300,X 
SBBB:BD 00 3B 144 LDA 53В00,Х 
8BBE:9D 00 57 145 STA $5700,X 
8BC1:BD 00 3F 146 LDA $3Е00,Х 
8BC4:9D 00 58 147 STA $5B00,X 
8BC7:CA 149 DEX ; ONE MORE ROW? 
8ВС8-ЕО 7F 150 CPX #$7Р + BYPASS UNUSED LOCATIONS? 
BBCA:DO 02 151 BNE NOFIX 
8ВСС:А2 77 152 LDX %577 
BBCE:EO FF 153 NOFIX CPX #$FF 
8BD0:FO 03 154 BEQ ROWDUN 
8BD2:4C OD 8B 155 JMP NXODD 
8BD5:A2 27 157 RONDUN LDX #$27 ; HANDLE SPECIAL MAPPINGS 
8BD7:BD 80 20 158 ODDTHD LDA $2080,X : 8 TO 7 
8BDA:9D OO 5C 159 STA $5С00,Х 
8BDD:BD 28 20 160 LDA $2028,X ; 64 TO 63 
8BEO:9D:80 5F 161 STA $5Е80,Х 
BBE3:RD AB 20 162 LDA $20A8,X  ; 72 To 71 
8BE6:9D 28 5C 163 STA $5C28,X 
BBE9:BD 50 20 164 LDA $2050,X ; 128 TO 127 
8ВЕС:90 AB 5F 165 STA $5FA8,X 
ВВЕР:ВО DO 20 166 LDA $20DO,X  ; 136 TO 135 
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PROGRAM 7-1, CONT'D... 

BBF2:9D 50 5С 167 STA 55С50,Х 
8BF5:A9 00 168 LDA #00 ; ERASE BOTTOM LINES 
8ВР7:90 DO ЗЕ 169 STA $3FDO,X  ; OF PAGE ONE 
BBFA:9D DO 5F 170 STA $5FD0,X : ОР PAGE TWO 
8BFD:CA 171 ТЕХ 
8BFE:10 D7 172 BPL ODDTHD 
8с00:20 09 8D 174 JSR SYNC ; OPTIONAL LOCK TO VBLANK 
8C03:8E 55 CO 175 STX PAGE2 : SWITCH TO PAGE TWO 
8с06: 177 ; *** START REMAP BACK TO PAGE ONE *** 
8C06:A2 F7 179 LDX #$F7 : BYPASS UNMAPPED BITS 
8С08:Е 00 44 180 GOEVN LDA $4400,X ; LINES 1-65-129-9-... 
8COB:9D OO 20 181 STA $2000,X | 
8С0Е:80 00 48 182 LDA $4800,X | 
8C11:9D 00 24 183 STA $2400,X 
8Cl4:BD 00 4C 184 LDA 54С00,Х 
8Cl7:9D 00 28 185 STA $2800,X 
SClA:BD 00 50 186 LDA $5000,X 
8с1р:9р 00 2C 187 STA 52С00,Х 
8C20:BD 00 54 188 LDA $5400,X 
8C23:9D 00 30 189 STA 53000,Х 
8C26:BD 00 58 190 LDA $5800,X 
8С29:90 00 34 191 STA $3400,X 
8с2с:вр 00 5C 192 LDA $5С00,Х 
8С2Р:9р 00 38 193 STA $3800,X 
8C32:BD 00 41 195 LDA $4100,X ; LINES 16-80-144-24-.. 
8C35:9D 196 STA $3C80,X 

197 LDA $4500,X 

198 STA $2100,X 

199 LDA $4900,X 

200 STA 52500,Х 

201 LDA $4D00,X 

202 STA 52900,Х 

203 LDA $5100,X 

204 STA $2D00,X 

205 LDA $5500,X 

206 STA $3100,X 

207 LDA $5900,X 

208 STA $3500,X 

209 LDA $5D00,X 

210 STA $3900,X 
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BC62:BD 
8С65:9р 
8C68:BD 
BC6B:9D 
BC6E:BD 
8C71:9D 
8C74:BD 
8C77:9D 
8C7A:BD 
8C7D:9D 
8C80:BD 
8C83:9D 
8C86: BD 
8С89:9р 
Всвс: BD 
8С8Р:9р 





8C92:BD 
8C95:9D 
BC98:BD 
BC9B:9D 
Вс9в: во 
8СА1:90 
8CA4:BD 
8CA7:9D 
BCAA:BD 
BCAD:9D 
8CBO:BD 
8CB3:9D 
BCB6:BD 
BCB9:9D 
8CBC:BD 
BCBF:9D 


00 
80 
00 
00 


PROGRAM 7-1, CONT'D... 


212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 


229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 


54200,Х 
$3D80,X 
84600,Х 
$2200,X 
$4A00,X 
$2600,X 
$4E00,X 
$2A00,X 
$5200,X 
52Е00,Х 
85600,Х 
83200,Х 
85А00,Х 
$3600,X 
$5E00,X 
$3A00,X 


$4300,X 
53Е80,Х 
84700,Х 
$2300,X 
$4B00,X 
$2700,X 
$4F00,x 
$2800,X 
$5300,Х 
$2F00,X 
$5700,X 
$3300,X 
$5B00,X 
$3700,X 
$5F00,X 
$3B00,X 








LINES 32-96-160-40-... 


LINES 48-112-176-56-... 
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BCC2:CA 
8CC3:E0 
8СС5:00 
BCC7:A2 
8СС9:Е0 
8CCB:FO 
всср:4с 


8С00:А2 
8CD2:BD 
8CD5:9D 
8CD8:BD 
BCDB:9D 
ВСОЕ: Вр 
8CE1:9D 
8CE4: BD 
8CE7:9D 
ВСЕА: ВО 
8CED: 9D 
SCFO:BD 
BCF3:9D 
8СЕ6:СА 
ВСЕ7:10 


8CF9: 


8CF9:88 
BCFA:FO 
BCFC:4C 
BCFF:20 
8D02:8C 
8ро5:20 
8008:60 


8009: 
8D09:2C 


8рос:10 
8DOE:60 





60 
FB 


8B 
во 
со 
ВЕ 


со 


PROGRAM 7-1, CONT'D... 


246 DEX 

247 CPX #$7F ; BYPASS UNUSED LOCATIONS? 
248 BNE NOFlX 

249 LDX %577 

250 NOFIX CPX #$РР 

251 BEQ ROWDUM 

252 JMP GOEVN 

254 ROWDUM LDX #$27 ; HANDLE SPECIAL MAPPINGS 
255 EVNTHD LDA $4080,X > 8107 

256 STA $3C00,X 

257 LDA $4028,X ; 64 то 63 

258 STA $3F80,X 

259 LDA $40A8,X ; 72 то 71 

260 STA $3C28,X 

261 LDA $4050,X з 128 TO 127 

262 STA $3FA8,X 

263 LDA $40D0,X ; 136 TO 135 

264 STA $3C50,X 

265 LDA $5FD0,X ; RECOPY BOTTOM LINE 
266 STA S3FDO,X 

267 DEX 

268 BPL EVNTHD 

270 ;  **** START REMAP BACK TO ONE **** 

272 DEY ; NEXT SCREEN PAIR? 

273 BEQ DONE 

274 JMP GOODD 

275 DONE JSR SYNC + OPTIONAL LOCK TO VBLANK 
276 STY PAGEL : SWITCH TO PAGE ONE 
277 JSR IOREST ; RESTORE ALL REGISTERS 
278 RTS : AND RETURN 

280;  **** VSYNC SUBROUTINE **** 

282 SYNC ВІТ VSYNC 2 TEST FOR VBLANK 

283 BPL SYNC ; AND WAIT FOR VBLANK 


284 NOSYNC RTS 


*** SUCCESSFUL ASSEMBLY: NO ERRORS 


193 
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GENTLE SCROLL 





ЗА 
19 а 
эв 51 
da nb 





Fig. 7-8. Hex dump of GENTLE 
SCROLLSET. 








33553558:884584888888333:88н838883 388 








А final detail finishes the mapping from page One to page Two. We clear the 
bottom line of both page One and page Two. If you don't do this, the descenders 
of lower-case characters will elongate and look very strange. 

When the mapping is completed, we jump to the optional SYNC subroutine 
and, then, flip the switch to page Two. 

The whole remapping process is then repeated, only this time we display page 
Two and remap back to page One. A dot initially on page One gets mapped one 
dot higher onto page Two and, then, gets remapped two dots up from where 
it started back on page One. 

Eight remappings аге done in four groups of two each. We end up back on 
page One with all the characters moved up exactly one dot row. 


USE HINTS 


Normally, you will save your program as a GENTLE SCROLL.SET on a disk 
containing the HRCG and LOADHRCG programs. When asked for the number 
of alternate character sets, answer one more than what you intend to use, and 
enter the GENTLE SCROLL.SET as your last alternate character font to be loaded. 
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А ready-to-go copy of the machine-lan- 
guage object code (GENTLE 
SCROLLSET) is provided on the com- 
panion disk to this volume. The Apple 
HRCG will automatically load the object 
code when it is entered by name as the. 
highest alternate character set. 

Should you want to copy this program 
“Бу hand," do the following: 

- Boot a DOS 3.3 disk that has room 
on it for the GENTLE SCROLLSET. 

. Get into the monitor by doing a 
CALL —151 ccr». 

. Enter the hex dump code of Fig. 
7-8. To do this, type ЗАЕЕ : EA 
«cr» . Then, type : 20 4А FF AO 
04 20 07 80 cr». Continue this 
process of entering a colon, 
followed by eight op code bytes 
anda «cr» lill you have entered 
all the code. 


Type BAFF L «cr» and verify the 
code by comparing it against. 
Program 7-1. Retype L «cr» as 
often as needed to go all the way 
through the program. 

. Restore DOS by using ЗООС 
ee. 


Type BSAVE GENTLE SCROLL.SET, 
ASBAFF, 15210. This should save 
Your program to disk. 

. То use your gentle scroll, do а 
BLOAD GENTLE SCROLLSET 
<@> as needed. If you are МОТ 
using HRCG, note that (1) you must 
protect the space BAFF-8DOC, (2) 
you must be displaying text on 
HIRES page One, and (3) a CALL 
35583, а CALL —29953, or a JSR 
ЗАЕЕ will move everything up eight 
dots and, then, return to your main 
Program. 





To activate your gentle scroll set, you have to go into the HRCG and find the 
subroutine call to its own abrupt scroll program. In machine language, use 
59214: 00 8B to use the gentle scroll and use 59214: 21 92 to use the abrupt 
scroll. Equivalent Applesoft locations appear in Program 7-1. 

These locations assume that you are using the same version HRCG that | am 
on a 48K Apple microcomputer. The hooks may change with a change in HRCG 
version or a change of program. What you do is reach into the host program 
and find that program's own call to its own abrupt scroll and, then, substitute 
the gentle scroll subroutine's starting address when it is wanted. There are more 
details on this in Enhancement 3. 

Note that the GENTLE SCROLL.SET is not relocatable as is. It will only work 
with a starting address of either $8AFF or $8800. There are three absolute jumps. 
needed that are beyond the range of a relative branch, and there are absolute 
calls to the SYNC subroutine. 


——— 
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Should you want to use the gentle scroll with some other HIRES character 
generator as host, just find the equivalent scroll hooks and use them. If you want 
to test the gentle scroll without a character-generator program, make sure you 
are displaying HIRES page One and do а JSR to $8800, a CALL 35583, ога CALL 
— 29953. This should move everything up one character row for you and then 
return you to your host program. 

Program 7-2 is an Applesoft demo called GENTLE SCROLL TESTER. You can 
use this one without any HIRES character generator. The program puts a lower- 
case message on the screen, and slowly scrolls it up for you. The process repeats 
over and over again until you press any key. 

Once again, all that the GENTLE SCROLL.SET can do for you is move existing 
HIRES characters or graphics up the screen. It cannot put anything new on the 
screen. For best effects, you will have to use HRCG or something similar to first 
enter your HIRES screen message. 

If you do not have the field sync mod in place, change $8D09 to $60 in 
Program 7-1. Otherwise, your gentle scroll may hang. 

And, again repeating, you will get the smoothest results if you have the 
hardware field sync modification of Enhancement 4 in place. 

Naturally, the gentle scroll will only work when a HIRES page is being dis- 
played. Should you drop back to a conventional LORES/text page, the gentle 
scroll will no longer work. A system RESET will sometimes drop you out of a 
HIRES character-generator program. To restore your gentle scroll, reactivate the 
HIRES display mode, and verify that the scroll hooks are still intact. 

Two gotchas. If you are using Applesoft POKES to connect the GENTLE 

CROLL.SET to HRCG, make absolutely sure you do it at the (ор of a screen. 
if you try this at the bottom of the screen, the first POKE sets up a scrolling 
address that is only “one half" correct, and the next scroll attempt bombs the 
program. And, never enter text while a gentle scroll is taking place as keys will 
be ignored for the time it takes to complete the scrolling. You can beat this with 
an add-on key buffer, but it is simpler to arrange your programs so as to never 
call for or accept a key input until after the display is stable. 

Likeso.... 


TWO USE RULES 





1. If you are using Applesoft 
POKE commands to connect 
your GENTLE SCROLL.SET, do 
so only at the TOP of the 


screen! 

. Do not call for or allow any 
лехі input while the gentle 
"scrolling is actually taking 

place. 





If your scroll seems slightly erratic, check first to make sure that the hardware 
teld sync mod is in place and that Program 7-1 is hooked into it. It also pays 
to have the fastest possible entry of characters on the screen, since the gentle 
scroll has to take time out to let the HRCG, or whatever else you use, put each 
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PROGRAM 7-2 
GENTLE SCROLL TESTER 








LANGUAGE: APPLESOFT 


10 REM t#thRRRRRR RRR 


RIGHTS RESERVED 





12 REM * 5) 
14 REM * GENTLE SCROLL * 
16 REM * TESTER * 
18 REM * * 
20 ВЕМ * VERSION 1.0 * 
22 REM * (9-28-81) « 
23 ВЕМ " 5 
24 REM “ COPYRIGHT 1981 * 
26 REM * BY DON LANCASTER * 
28 REM * AND SYNERGETICS * 
30 REM * bd 
32 REM % ALL COMMERCIAL * 

* * 

* * 

* * 


diee iei o Ree 


50 REM THIS PROGRAM TESTS AND 
52 REM DEMONSTRATES THE GENTLE 
54 REM SCROLL OF ENHANCEMENT 7 
56 REM FOUND IN ENHANCING YOUR 
58 REM APPLE II, VOLUME I. 


60 REM THE SUBROUTINE "GENTLE 
62 REM SCROLL.SET" IS NEEDED. 


64 REM THE FIELD SYNC MOD 
66 REM ОЕ ENHANCEMENT 44 15 
68 REM NOT NEEDED, BUT WILL 
70 REM GIVE A MUCH SMOOTHER 
72 REM SCROLLING ACTION. 


80 REM FOR BEST EFFECTS, 

82 ЖЕМ USE THE GENTLE SCROLL 
84 REM WITH A HIRES CHARACTER 
86 REM GENERATOR SUCH AS 

88 REM HRCG OR HIGHER TEXT 

90 REM INSTEAD OF THIS PROGRAM. 





100 TEXT : HOME : УТАВ 20: PRINT 
"HELLO! І AM YOUR ...." 





| 


NEEDS: GENTLE SCROLL SET 
FIELD SYNC MOD 
(OPTIONAL) 
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PROGRAM 7-2, CONT'D... 


105 


110 


200 


210 
220 


230 
235 


240 
245 


250 
255 
260 
265 
267 
268 


270 


280 





1000 


1010 


1020 


НІМЕМ: 35500: ВЕМ PROTECT 

GENTLE SCROLL SET SPACE 
PRINT "BLOAD GENTLE SCROLL.S 
ET": REM CTRL D 


HGR : РОКЕ - 16302,0: CALL 
- 1998: REM FULL HIRES SCR 
EEN 
HCOLOR= 3 
H = 100:У = 184: REM SET TE 
XT START 


GOSUB 2000 

FOR N = 1 TO 1000: NEXT М: CALL 
35583: REM "GENTLE" 

H = 100: GOSUB 2000 

FOR N - 1 TO 1000: NEXT N: CALL 
35583: REM "SCROLL" 

H - 100: GOSUB 2000: REM "TE 
STER" 


FOR N = 1 TO 3000: NEXT N 

FOR М = 1 TO 9: CALL 35583: NEXT 
N 

FOR N - 1 TO 3000: NEXT N 

IF РЕЕК (49152) > 127 THEN 
POKE 49168,0: PRINT : PRINT 
"RUN MENU" 

REM DELETE 267 IF AUTO MENU 

IS NOT IN USE. 


IF PEEK (49152) > 127 THEN 
POKE 49168,0: TEXT : HOME : 
PRINT "PARTING IS SUCH SWEE 
T SORROW": VTAB 22: END 

CLEAR : HIMEM: 35582: GOTO 2 
20: REM GO ROUND AGAIN IF N 
O KEY HAS BEEN PRESSED 





REM CHARACTERS C,E,G,L,N,O 
,R,S,T FOLLOW IN ORDER 


HPLOT Н + 4,V + 2 ТОН +1, 
V * 2: HPLOT H,V + 3 TO H,V + 
HPLOT H + 1,у + 6 TO H + 


HPLOT H,V + 4 тон + 4,V + 


ТОН + 4,V + 3: HPLOT Н + 

,Vo* 2 TO H + 1,V + 2: HPLOT 
„У + 3 TO H,V + 5: HPLOT H + 
„У + 6 TO H + 4,V + 6: RETURN 


























Gentle Scroll 199 

















а с + 
Е шю =, + 
ЕО ыша сш 
9 оча + + 
ы,ш о 
е a+ >+8 
S В.р 
>ш 
> 
5 5 
c с 
б - 
о 
c 
S 











psn В e 8 
есоре > Q р 
онано E я B 
SERES B E 8 
бж єв то + 
ot о + T го + е 
е е “не Десен +> +» 
ЭЭ JE qe c Gm маню аво 
Сул та +++ + ыж” - + 
e at + + шш + +0 
+ р +5 >>> о>» >> Е> 
+ Е> Е>----> 10-7: іш 3 
ШЕ ші eem ж AO от 
ш ш em т атр 
е E +++ >+а + +5 е + + 
"OQO 9 “о - 2o 
By el Es о ИЕ eB pp EE rm 
эштэсошжоооосоОоР»ШОШМИМОӨНӨН 
- еее в е S 
ч““>жер»% +m Ғы ne 
я E S Cu 
дар set ош tutt шев 
> > >>> n» >>> ООФ 
в ошезше зо Е кк AA 
ов км ОөчоөОо«жсзОоччоОосонж 
я о он "I a ышш = 
Б + ва + Ей + + +0 > + м + + + а > а 
= ш ш Ж. a шээс 
шо шо шшш mm Dmmm өс 
а в в а е 5 e 
FS NE 5 % 8 © 
A 508 5 © 
SES а 55 8 5 


: REM 


RETURN 


1 ТО 6: GOSUB 3000 
NEXT М: 
РОІТ DOWN SIX LETTERS 


=H +8: 


2000 FOR N 
H 





REM FIND LETTER C 


RETURN 


R GOSUB 1010,1020,1030,1040, 
ODES 


3000 READ CHARACTER: ON CHARACTE 
1050,1060,1070,1080,1090 


3010 


DATA 3,2,5,9,4,2,8,1,7,6,4, 
4,9,2,8,9,2,7: REM SAYS "GE 


NTLE/SCROLL/TESTER" 


9999 
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де of characters on the screen. If you make each character line the same length 
and put them on the screen with fast machine-language code, you will get the 
smoothest results. 

Funny things may happen if you try to use GENTLE SCROLL.SET on a colored 
background; particularly, if it's an “illegal” color. To handle colored back- 
grounds, you will have to suitably modify the “clear both bottom lines” code 
into something that handles each color byte individually. One alternative is to 
simply copy the bottom line of page One to the bottom line of page Two. This 
gives you color but introduces a lower-case elongating descender bug. 

To try this color background alternative, replace GENTLE SCROLL.SET 88F5: 
A9 00 9D 00 3F with 8BF5: BD DO 3F EA EA. 

Once your gentle scroll is working, you should be able to think up all sorts 
of new possibilities. How would you handle the terrain flyby in a bomber 
mission or a road in a road race? How about dice, roulette wheels, or menu 
selectors that rotate? What about several things that are moving at once? Note 
that partial screen gentle scrolls can run much faster than whole screen ones. 
Note also that for graphics use, you might be able to jump two or more scan 
lines at a time, rather than just one ф 


The programs GENTLE SCROLL.SET, 
GENTLE SCROLLSET.SOURCE, and 
GENTLE SCROLL TESTER are included 


оп the companion diskette to this 
volume. 


All are fully copyable. 

















Enhancement 





FAST BACKGROUNDER 


A HIRES utility that gives you any 
of 191 solid background colors or 
18,446,744,073,709,551,616 pat- 
terns, It runs seven times faster 
than you might expect and it is 
easily made glitchless. 


FAST BACKGROUNDER 


There is a convenient and useful HIRES screen clear subroutine that is avail- 
able as part of your Apple's firmware. This code is provided both іп the Ap- 
plesoft ROMs and in the Programmer's Aide that comes with the Integer ROMs. 
The background clearing sub is easily reached from any language and is the 
“standard” way of clearing either HIRES screen. 

It is also pitiful. 

It is pitifully s/owin that it takes over eight times as long to clear the screen 
as is necessary, resulting in а slow and ugly glitch during screeri clearings. And, 
it is pitifully weak in that it only lets you clear to a paltry 8 of the 191 HIRES 
colors. 

The FAST BACKGROUNDER is an incredibly fast machine-language module 
that will give you a right-now clear of HIRES to your choice of any 32 of the 
possible 191 color backgrounds or 18,446,744,073,709,551,616 color back- 
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found patterns. The module is designed to load into the protected program 
space of HRCG (High-Resolution Character Generator) as the highest alternate 
character set, but the backgrounder can be used from any language or any 
graphics system. 

The FAST BACKGROUNDER is also useful in showing us quite a bit about the 
Apple's HIRES color limits and capabilities. You can easily adapt parts of the 
program for your own special uses. You can also use the magic bit combinations 
to fill in your own colors in any way that you like. 

As with any program, there are trade-offs. In exchange for the blinding speed 
and the mind-boggling choice of colors and patterns, we end up with a fairly 
long module (512 bytes) that only can do a full clear of HIRES page One. While 
the module can handle any and all of the HIRES patterns and colors, its files are 
Presently set up to only hold 32 different colors or patterns at any one time. 
More patterns or colors are easily swapped back and forth to disk or from your 
controlling program. You can easily customize the backgrounder or use the ideas 
behind it to handle almost any clear of any size, shape, or page that you like. 

You can also easily modify the upcoming FAST BACKGROUNDER.SET pro- 
gram to handle either page Two or your choice of either HIRES page. While the 
remaining visual glitch with this program is utterly negligible compared to the 
ugly transient that you get from the usual HIRES slow clear, we will also show 
you а way to get an absolutely glitchless and “invisible” clear to any color in 
the blink of an eye. 

Let's see how the Backgrounder works . . . . 


atsa dots 


How much do you know about the HIRES capabilities of the Apple? Which 
one of the following is correct? 


() In HIRES, the Apple can put a single dot in any of 560 
possible positions on any horizontal line 


(1 In HIRES, the Apple can only put a maximum of 280 dots 
on any horizontal line. 


(3 In HIRES, the Apple can only put a maximum of 140 
green dots on any horizontal line. 


() Under worst-case conditions, the Apple will only allow 
40 color changes across the screen. 


The answer, of course, is yes. 

All of these statements are true. The Apple's horizontal resolution in HIRES 
is 40 dots, 140 dots, 280 dots, or 560 dots, depending on what you care to call 
а dot and how that dot has to relate to the others. 

Let's see if we can't straighten this mess out some. Refer back to Fig. 7-5 of 
the previous enhancement.to get us started 

As Fig. 7-5 showed us, there are forty bytes stored in memory for each 
horizontal line. Each byte is responsible for seven dots on the line. The leftmost 
byte is called the base address, The bytes continue in memory as base address 
+0, base address +1, base address +2, and so on, to base address +$27, 
which is the fortieth and rightmost byte on the line. The actual HIRES addresses 

* both pages were listed for you in Table 7-1 of the previous enhancement. 

As the sketch in Fig. 7-5 shows us, each HIRES byte, in turn, has eight bits. 
зеуеп of these bits are used to represent dots on one horizontal line. These dots 
аге lit if the bit is а “опе” and are unlit or black if the bit is a “zero.” 














шаша 
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The bottom seven bits in the byte map themselves back wards onto the screen. 
Thus, the least significant bit is the earliest and the leftmost, and the next-to-most 
significant seventh bit is the latest and, thus, the rightmost one to get plotted on 
the screen. 

What about the eighth, or most significant bit? This bit acts as a shifter that 
either does nothing or else moves а/ of the other seven dots one-half of a dot 
to the left. This shifting is detailed in Figs. 8-1 and 8-2. 


— 





A ZERO IN THE NSB А "1" IN A DOT РОЗ! 
PICKS THE UNSHIFTED LIGHTS THAT DOT. 

COLORS OF GREEN LEAVE THAT DOT OFF. 
AND VIOLET. 




















SECOND HORIZONTAL 
DISPLAY WORD 









FIRST HORIZONTAL, 
DISPLAY WORD 























= PUES 
099099000909090 


EVEN оро 








DISPLAY DISPLAY ‘POSITIONS OF 
I~ LEFT EDGE ВҮТЕ BYTE peso 


OF SCREEN 


Fig. 8-1. Ном unshifted colors are mapped onto HIRES screen. Note that even and odd word color bit positions are different. 


И the most significant bit is a zero, all the dots go where you would expect 
them to go. If the most significant bit is a one, all seven dots are all shifted 
together one-half dot to the right of their normal position. 

There are two reasons why you might like to shift all seven dots. In a black 
and white HIRES display, a half-dot shift of a dot can appear to double the 
apparent resolution on а slanty line, giving you the illusion of a 560-dot horizon- 
tal resolution. Unfortunately, all seven dots in a byte must shift or unshift to- 
gether, so this illusion fails if there is too much detail in the picture. The 
double-resolution illusion works best on simple large line figures that do not 
overlap. 

Shifting is also useful to smooth out or “round” characters іп a HIRES charac- 
ter set, or for other small and solid symbols where a half-step horizontal offset 
will even things out. Once again, all seven dots of a single byte must be shifted 
or unshifted at once. 

The second reason why you would want to shift all seven dots is that it gives 
you new colors on the screen. ы 
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A ONE IN THE NSB 
PICKS THE SHIFTED. 
COLORS OF BLUE 

АМО ORANGE. = 





АЗ BEFORE А 21 

IN А DOT POSITION 
LIGHTS THE DOT. A "0" 
LEAVES THAT DOT OFF. 
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FIRST HORIZONTAL, 
DISPLAY WORD 








SECOND HORIZONTAL, 
DISPLAY WORD 
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POSITION OF 
UNSHIFTED. 
COLCR DOTS 


Fig. 8-2. How shifted colors are mapped onto HIRES screen. MSB of each display word shifts ог unshifts seven dots at once. 


Each dot position on a black and white set can either be lit or unlit. Lit gives 
you a white dot and unlit gives you a black dot. There are 280 possible dots on 
a horizontal line, equal to 40 bytes of 7 bits each. These dots can be placed in 
any of 560 possible positions, provided each group of 7 dots is shifted or not 
shifted as a block. 

You will get the same black and white display on a color tv set if you cancel 
the color burst with the software-controlled color killer of Enhancement 2, ог 
if you back all the color controls completely off. 

Things get much more complicated if you want a color display. There is no 
way to produce a single white dot on a color tv set when the set is in its color 
mode. Each dot has to be a color since each dot consists of some red, blue, or 
green phosphor bars or dots on the screen. 

One way to gain insight into how a color tv works in an Apple display is to 
assume that the exact position of the dot determines the color that will be 
displayed. If your dots are-unshifted, you can assume dot-position zero will be 
Violet and dot-position one will be green and dot-position two will be violet 
again, and so on across the screen. 

If you have shifted your dots one-half dot, as we did іп Fig. 8-2, you can 
assume that dot-position zero will be blue and dot-position one will be orange 
and dot-position two will be blue again, and so on across the screen. Your Apple 

n give you either green and violet dots inside a 7-dot byte, or else, it can give 

au orange and blue dots, again inside a 7-dot byte. You get the green and violet 
by unshifting the seven dots and you get the orange and blue by shifting the dots. 
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What actually goes on inside the tv is more complicated. Each dot pair 
represents one cycle of the 3.58-megahertz color reference provided by the 
Apple and used by the tv. The phase shift, or relative time delay, between this 
reference burst and the presence of a dot decides the color for that dot. Once 
the color is decided, the red, blue, and green phosphors are lit in the magic 
combination needed to get the right color. 

But, we are mainly interested in results rather than how those results are 
obtained. Instead, simply assume that each dot position is a unique color, 

Like 50. . 


Dot position 0.0 - violet 
Dot position 0.5 . . . . blue 
Dot position 1.0... . green 


Dot position 1.5 . . . . orange 


Dot position 2.0 . . . . violet 


Dot position 2.5... . blue 
Dot position 3.0... . . green 
Dot position 3.5 . . . . orange 


22. апа so on across the screen. 

Now for the tricky part. The way you get a white dot or line on a color set 
is to light a pair of dots. Since green and violet are complementary colors, 
lighting both of them beside each other will appear to give you a double-wide 
white dot. Similarly, orange and blue are complementary colors. Lighting a pair 
of these, side-by-side, will also give you a white dot. 

Thus, it takes two dots, side-by-each, to give you the illusion of a white dot 
ona color tv. What really happens is that two adjacent dots of complementary 
colors get lit and you end up with the illusion of white light. 

All of which says that the color resolution of your Apple is only half as good 
as the black and white resolution. You can only put down 140 green dots on 
a horizontal line. Similarly, you can only put down 140 dots of any of the three 
other colors of violet, orange, or blue. You also can only put down 140 white 
dots, since a white dot really is a pair of adjacent color dots. 

Now, that sounds really awful, but most of it is the fault of the color tv, owing 
to the subcarrier method used to extract color. You can beat all this by going 
to a direct red, blue, and green video, like we may do in a later enhancement. 
If you are willing to directly enter the color guns, and if you are willing to add 
a small and very fast RAM after your Apple's circuitry, there is virtually no limit 
to the resolution, color range, or grey scale that you can get from your 
Apple. 

Right now though, there is also a further limitation, since each seven adjacent 
dots must be shifted or unshifted together. Thus, you cannot normally have a 
blue dot and а green dot right beside each other. Color changes are best left for 
different 7-dot bytes, rather than being done inside a single 7-dot byte. At worst, 
you could be limited to as few as forty color changes across your screen if you 
are not careful about which colors have to go together. 

By the way, these are "nominal" colors. Your color tv settings can make a 
big difference in what you see or get. 

So, we see that there are absolute color limits which are set by the way the 
Apple and your color tv interact. We must obey these rules, at least for now. 
But, we are free to play any games within these limits to create the illusion of 
more colors than you'd think possible. This gets tricky, but it really works 
good. 
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Let's sum all this ир... 


APPLE COLORS AND 
RESOLUTION 





‚ In black and white, the Apple 
can put 280 dots or undots 
across the screen. 


These dots or undots can go 
in any of 560 possible loca- 
tions so long as 7 dots or un- 
dots in a byte are shifted at 
the same time. 


. In color, the Apple can only 


put down 140 dots of a given 
color on a horizontal line. The 


only dot colors are green, vio- 
let, orange, and blue. 


Green and violet are done 
with unshifted 7-dot bytes. 
Orange and blue are done 
with shifted 7-dot bytes. You 
cannot mix shifted and unshift- 
ed dots inside а 7-dot byte. 


Also in color, the Apple can 
only give you a black and 
white resolution of 140 dots 
Since a complementary dot 
pair must be lit to get the illu- 
sion of white light. 





The general idea is to use larger areas and many dots to trick the eye into 
seeing colors that are not there. This, of course, is the way all color printing 
works. Fortunately, the eye is much better at resolving detail than it is in resolving 
color, so we can get away with stunts like this. Let's see what we can get in the 
way ой... 


More colors 46 


A color tv only has three colors it can produce. These are red, blue, and green. 
But, it obviously plays games with combinations of these colors to give you a 
wide spectrum of colors; even some that do not exist elsewhere. 

You can do the same thing with your Apple. One possibility is to flash different 

olors in the same position on alternate fields. We may look at this in a future 
enhancement. This method will give you some apparently individual lines and 
some dots of different colors, but it also tends to flicker and it has other limiting 
factors. 
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Instead, we will note that most colors used on your Appie will be used over 
a fairly large area. The-days of stick figures and open lines on Apple HIRES are 
long since gone. Most colors will be presented over a wide area, rather than as 
a single line. Our Backgrounder will use the entire screen to create the illusion 
of having lots of HIRES colors. The same ideas are easily used to fill in colors 
inside any shape you like. 

The key to more colors is tricking the eye. One trick we can pull works in the 
vertical direction. If you take a pair of adjacent horizontal lines, and make one 
blue and the other green, you will see aqua, particularly if there are many line 
pairs in use. By itself, use of line pairs of color should take the basic 6 colors 
and extend them to 21. This happens since 6 + 5 +4463 +2 +1 = 
the number of possible pairs of 6 colors available. 

Most of these "new" colors formed by pairs of horizontal lines are very 
appealing and useful. A few are downright awful. Some look very good on a 
color set, while others stand out on a black and white display. A very careful 
choice of colors can give you the best of both worlds, with stunning colors that 
can still be resolved easily on a black and white display. This little detail can 
get very sticky if you are designing programs that can run on either type of 
tv set. 

Can we gain still more colors? What about the horizontal direction? Suppose 
we mix a color, then black, a color, then black, and so on? Or white, then a 
color, white, then a color, and continue this. Or, even alternate pairs of white 
and black spaced colors one line above the other? What you end up with is lots 
more colors. Some of these will have a texture to them and others will have lots 
of individual dots, sort of like the colors in the Sunday comics. Many of these 
new colors will be very useful. 

We will look at fourteen of these “пеуу” colors. This brings up the total of solid 
or nearly solid colors per horizontal line to 20. Now, go to your alternating line 
pairs, and you end up with a total 20 + 19 +... + 2 + 1 = 210 possible 
HIRES colors. Nineteen of these have ugly black stripes in them, but | count 191 
that are genuinely useful HIRES colors so far. You might find more when you 
start to look at odd-ball bit combinations. 

The theoretical number of different HIRES colors is much higher than 210, but 
there are many duplicate, ugly, or useless results along the way. 

We will define our background colors with an 8-byte color cell as shown in 
Fig. 8-3. The cell is 4 bytes long by 2 bytes high. We have to be 4 bytes long 
since some of the color patterns will not repeat exactly until 28 dots. We end 
up with 2 bytes in height because we may use alternating line pairs for some 
colors. 

Our cell is two scan lines deep, starting with an even scan line and ending with 
an odd scan line, We then are free to use our second line in any of several ways. 
For instance, we can simply repeat the upper line for the traditional colors. We 
сап make this second line white to lighten the color. In theory, we can leave 
the second line black to darken the color, but this tends to be too striped for 
most uses. We can also use our second line to mix hues for us, perhaps combin- 
ing blue and green to get aqua, and so on. 

Finally, we can use our second scan line to mess with the texture of our 
screen. We can use it to minimize the texture of the “comic БооК” colors as 
we will see shortly. Also, we сап use this second scan line to purposely enhance 
texture—say, to emphasize a pattern or a design. 

Each 8-byte color cell will be controlled by an 8-entry color pattern file. The 
file values start at the top and work across. Thus, the first pattern is in the upper 
left, the fourth one is in the upper right, the fifth one is in the lower left, and, 
finally, the eighth one controls the bottom right seven dots in the cell. 
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Fig. 8-3. Fast BACKGROUND SET program uses an 8-byte color pattern file to map а 56-dol, 4x2-byte color block on the screen. 


If our colors are going to appear to be continuous over the entire screen, we 
' ave to obey an important rule . . 


For continuous background color, 
the bit patterns must repeat 
EXACTLY when going across both 


7-dot-byte boundaries and 8-byte 
cell boundaries. 





What this says is that you have to be very careful in your choice of the ones 
and zeros in your individual bits and bytes. Otherwise, you will get lots of stripes. 
across the screen and end up with a pattern instead of a color. 

Now, if you want patterns, that's fine. Just stuff any old 64 bits into your cell 
(56 color dots and 8 half-dot shifts) and out comes a pattern. Some of these 
patterns are stunning. Some are ugly, others awful. Many are boring. Some can 
be used to, say, do a chain-link fence, or frost glass, or simulate a lace dress. 
Others are nice for curtain effects, used either in a window or as a full-screen 
stage. 

There are more than several patterns available to you. Quite a few, in fact. 
Run through the mathematics and you'll find that there is a grand total 
of 186,446,744,073,709,551,616 possible patterns for your 8-byte cell. 

This is so many patterns, in fact, that you might never be able to get through 
them all. So we will all share the work. Assume that there are only 125,000 
readers of this book. A gruesomely conservative thought, but let’s assume it 
anyway. Your share of the patterns will then only be a measly one and a half 
quadrillion patterns, give or take a few. 

What I'd like you to do is this. Go through your share of the patterns one by 

ve and when you find some really and truly outstanding ones, jot them down 

the card that is in the back of this book and mail it in, and we'll publish the 
vest patterns, textures, and colors that we get in a future volume of enhance- 


ments. 
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Pattern codes 


Back to our colors. Seven is a nasty number. It is both odd and prime. 
Remember that we must get the dot patterns to repeat every byte and every cell, 
continuously, if we are to have a solid color rather than a pattern. This severely 
restricts the codes you can use. There are only two patterns that will repeat 
identically with every byte. There are four new patterns that will repeat identical- 
ly with every second byte. 

If we wait for a period of three bytes for our patterns to repeat, we pick up 
four more new and different patterns. Actually, these won't quite map into our 
upcoming 4-сей backgrounder space, and we will be violating our “it must fit 
exactly” rule. But, we will show you these three-byters just in case you want 
to play with them. 

For maximum flexibility and the greatest possible choice of colors, we have 
10 be willing to make four bytes, in a row, have different codings. We also have 
the option of stacking two different pairs of four bytes for even more color 
combinations. 

The 4-byte patterns will give us ten new and useful combinations, Actually, 
there are many more 4-byte patterns possible, but these are either offset replicas 
of other 4-byte patterns, or else, they give the same color but a different texture. 
More details on this will be given shortly. 

Summing things up . . . . 














NEW HIRES COLORS 


NO.OFBYTES NO. OF NEWCOLORS 


One 2 
Two 4 
Three 4 


Four 


Total number of combinations of pairs of 
20 colors = 20+19+18+17+...,ог 
a(n+1)/2 = 210. 





Total number of obvious and useful 
HIRES colors = 191. 





Someone else will most likely come up with some more subtle bit combina- 
tions that can lead to even more HIRES colors. But, no matter whose math you 
use, you will see that... 


There are many more HIRES colors 


available on an Apple than there 
are LORES colors! 





The big advantage of the 121 LORES colors of Enhancement 5 was that you 
got more hues, while with the HIRES combinations, you tend to get more shades 
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* fewer actual hues. Either route will lead to some mind-blowing color 
displays. 
Let's look at these 1-, 2-, 3-, and 4-byte color combinations in detail, We will 
first look at combinations that only involve a single horizontal line. 
There are only four possible bit patterns that leave all four bytes identical. Two 
of these are white, and two are black. Here's what they look Ке... 


$00-00-00.00 00000000000C00000000000000000 (white) 


580-80-80-80. ооооосоооосоооооосоооооооооо өлө” 
STF-7F-7F-7F 4M 






eee юз) 





ЗЕЕЕЕЕЕРЕ i 000 oio; 


There are two black patterns and two white ones. Both blacks will look the 
same. The whites will be pretty much the same, although one may end up 
slightly "warmer" than the other. Usually, you use unshifted black and white 


with the upcoming green and violet, and use shifted black and white with 
orange and blue. 


Note that there is no way to get any other continuous HIRES color by writing 
the same value to each and every byte. You can only get white and black this 
way. Any other values will give you Stripes or patterns rather than solid colors. 

If we go to pairs of horizontal bytes, we add these four solid colors . . . 

$2А-55-2А-55 OS eocececececeoecececececeo green) 
SAA-D5-AA-D5 өсөсөсөсөсөсөсвсөсөсөсөсөсөс lorange)* 
$55-2А.55-2А Oeceoececececececececececece violet) 


505АА 0544 ОФОӨОӨСӨСӨСӨСӨСӨСӨСӨ 0080808 ое: 


өв color 





These are the usual "eight" colors provided by Apple in its HIRES routines, 
You have four solid colors, two blacks, and two whites 

Note particularly how each second byte has to have a different bit pattern 
for the colors. The bit pattern has to be continuous over the screen. Since there 
are an odd number of bits per byte, this means that the 2-byte colors have to. 
be stored as different values. 


To make things more interesting, let's now look at four more new 3-byte 
patterns... . 





а 549-2512 ФОС! ОФОСФООФОСФОСФСО із!) 
ха: ФООФООФОСФООФОСФОСФОО a2 
535586 ОФӨСӨӨСӨӨСӨӨСӨӨСӨӨСӨӨ 2) 
явьовЕо ОӨӨСӨӨСӨӨСӨӨСӨӨС! 








e000 oy 


At first glance, you might think we would have more 3-color patterns than this. 
We already have used up the all-white and all-black Patterns as 4-byte colors, 
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And, the other combinations are simply “phase shifts” or offsets of what we 
already have. For instance, the pattern $25-12-49 gives us the same color as 
$49-25-12, only with the actual dot pattern shifted one byte to the right. This 
offset shift will give us nothing new in the way of color, but might be useful to 
minimize any background pattern. We will see a good example of this with our 
4-color patterns. 

In general, the 3-color patterns are kind of bland greys and are not too 
exciting. Their use gets complicated by the need for us to handle things “Бу 
fours’ in our upcoming fast background program. While we won't be using these 
too much here, you might find the 3-byte colors useful additions to your bag 
of tricks. 

Some of the 4-byte patterns are really neat. There are ten new and useful ones. 
We pick up four new pastels, two greys, and four dark colors. Let's start with 
the pastels... . 





51224448 ФОООӨСООФОООФОСОФОООФООСӨСОО (йите green) 
591420488 ФОООФОООФОООФОСОФООСФООС! 


52244081 ОФОСОФОООФОООФОООФОООФОООФОСО (пас) 





ОО (sky blue)" 


зА204489: ОФОСОФОООФОООФОООФОООФОООФОО еде)" 


© = ated color 


These four new "pastel" colors will also have four identical other ones, offset 
by two bytes. These add nothing new in the way of color, but give us a way 
to break up any background pattern. 

For instance, we сап do this for lime green . . . 


ФООСФОССФООСФО 

ОООФОСОФОСІ 
eoooeocoeocceo 
eocooeocoeooceo 


eoooeoooeooco 

















. . . here we used the same pattern on all four scan lines. But, if we alternate 
the regular and the offset pattern on alternate scan lines, note how the texture 
“breaks ир”... 


eocoecoocecooeo 
ООФООСФОООФООО 
ФОССФСОСӘСОСФО 
ООФООСФОООФОСОО 
ФОССФСООСФООСФО 


Both displays are lime green. But the bottom choice will give us а more 
uniform lime green, since the texture is broken up. This becomes most obvious 
with the upcoming dark colors. 

We will shortly be listing some of these color patterns. A “normal” color 
pattern should usually be used on the even scan lines of any color area, while 
an "offset" color pattern should be used on the odd scan lines of any color area. 
You are, of course, free to do whatever you like for special effects. Sometimes, 
you might want to enhance texture rather than trying to minimize it. 
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Неге are our two new greys . . . 
53366403 ӨӨССӨӨССӨӨССӨӨОСС 
58306ССА9 Ф 





Once again, there really are at least four greys—one normal and one offset by 
two bytes. Notice one more time how we can emphasize or reduce texture with 
the choice of regular or offset colors 





These are subtle differences to be sure, but they get important real quick when 
you try to build something that looks good both on а black and white and a color 
tv screen 

Our final four colors are dark ones, since they hit one color dot, miss the next 
| dot of the same color, then hit the next one, and so on. Неге is what they look 
fiers s 


36Е-50-3877 Oe ee C: 





сФФФСОФФФОФФӘСФФФСӘФӘ се 
"008857: ОФФФО 











есе (navy blue)” | 
550-38-77-:Е ӨСӨӨӨСӨӨӨСӨ (forest green) 
f зекооввғ? ӨСӨӨӨСӨӨӨСӨ (brown)* 





These tend to give a “comic book” or “Sunday funnies” effect at close range 
and are just what you need to add variety to a HIRES color palette. 

You could probably go on to 5-byte colors, and 6-byte colors, and so on, but 
things would most likely end up so spread out that you no longer would see any 
apparently solid colors. You could also go to patterns of two lit, three off, and 
50 on, as well. Chances аге that most of these new patterns will either be obvious. 
or else very near to what we already have. But—check them out anyway, since 
there are bound to be some useful surprises along the way. 

If you do go into your own exotic patterns, be sure to remember our rule that 
the bit pattern on the screen must repeat exactly across each byte boundary and 
for each 8-byte, 4 X 2 cell. 

Add everything useful up so far, and you get 20 one-line colors. We are now 
free to use our second scan line to add to cur basic 20 colors. As we have seen, 
you can use this second line to duplicate colors, to offset bytes for minimum 
patterns, to mix hues together, to lighten, to darken, or to actually emphasize 
patterns. These new combinations give you at least 220 colors. This drops to 191 
when you remove the 19 uglies that you get when you try to darken with a black 
line. 

Table 8-1 shows my choice of color-file values for the thirty-two most useful 
colors and patterns. We start with Apple's own six colors. Here the first and 

econd scan lines are identical. Then we add fourteen of the 4-byte colors. With 
ће 4-byte colors, we use the second scan line to offset and minimize any screen 
patterns. 


—€———— — EHE i | 
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Table 8-1. File Values for “Stock” Background Colors 











































= 
сома 

NO. COLOR HEX FILE VALUES DECIMAL FILE VALUES LINEUSE 

O blacki $00-00-00-00-00-00-00:00 00-00-00-00-00-00-00-00 duplicate 

1 green 52А-55-2А-55-2А-55-2А-55 42-85-42-85-42-85-42-85 duplicate 

2 blue 505-АА-05-АА-05-АА-05-АА 213-1 70-213-170-213-170-213-170 duplicate 

3 whitel $7F-7F-7F-7F-7F-7F-7F-7F 127-127-127-127-127-127-127-127 duplicate 

4 black2 $80-80-80-80-80-80-80-80 128-128-128-128-128-128-128-128 duplicate 

5 violet $55-2А-55-2А-55-2А-55-2А 85-42-85-42-85-42-85-42 duplicate 

6 orange 5АА-105-АА-05-АА-05-АА-05 170-213-170-213-170-213-170-213 duplicate 

7 white2 — SFF-FF-FF-FF-FF-FF-FF-FF- 255-255-255-255-255-255-255-255 duplicate 

в purple 511-22-44-08-44-08-1 1-22 17-34-66-08-66-08-17-34. offset 

9 navy $91-А2-С4-88-С4-88-91-А2 145-162-196-136-1 96-136-145-162 offset 

10 forest 522-44-08-11-08-11-22-44 34-66-08-17-08-17-34-66 

11 brown 5А2-С4-88-91-88-91-А2-С4 162-196-136-145-136-145- 162-196. 

12 grey? $33-66-4C-19-4C-19-33-66 51-102-76-25-76-25-51-102 offset. 

13 gev2 583-Е6-СС-99-СС-99-83-Е6 179-230-204-153-204-153-179-230 offset 

14 ime 56Е.50-38:77-3-77-6Е-50 110-93-59-119-59-119-110-93 ойе 

15 lilac 550-38-77-6Е-77-6Е-50-38. 93-59-119-1 10-1 19-110-93-59 offset 

16 beige $EE-DO-B8-F7-BB-F7-EE-DD. 238-221-187-247-187-: offset 

17 sky $00-BB-F7-EE-F7-EE-DD-BB 221-187-247-238-247-238- offset 

18 aqua $2A-55-2A-55-D5-AA-D5-AA 42-85-42-4 13-170-213-1/0 ША 

19 чегі $2A-55-2A-55-55-2A-55-2A — 42-85-42. 5-85-42-85-42 mix hues 

20 yellow 52А-55-2А-55-АА-05-АА-05 — 42-85-42 5-170-213-170-213 mix ше 

21 powder 805-АА-О5-АА-55-АА-55-АА 213-1 70-213-170-85-42-85-42 mix hues 

22 pink 505-АА-05-АА-АА-05-АА-05 213-170-213-170-170-213-170-213 mix hues 

23 magenta $AA-D5-AA-D5-55-2A-55-2A 170-213-170-213-85-42-85-42 mix hues 

24 olive $2A-55-2A-55-7F-7 F-7F-7F- 42-85-42-85-127-127-127-127 lighten 

25 silver —$D5-AA-D5-AA-FF-FF-FF-FF 21 3-170-213-170-255. lighten 

26 salmon $AA-D5-AA-D5-FF-FF-FF-FF 170-213-1 70-21 3-255- lighten 

27 mauve $55-2A-55-2A-7F-7F-7F-7F lighten 

28 drapel 4С1-АЗ-А5-89-2С-08-СО-ҒЕ 193-163-165-137-44-8-205-254 pattern 

29 drape2 $9A-43-54-18-05-26-53-01 154-67-84-24-5-30-83-1 pattern 

30 chain! $00-7F-00-7F-7F-00-7F-00 0-127-0-127-127-0-127-0 texture 





31 chain2 $OF-OF-OF-OF-78-48-78-78 | 15-15-15-15-120-120-120-120 (ейше | 





NOTE: Colors will vary with tv and its adjustments. 


Next, in the file, are six mixed hue colors, Of these, aqua and magenta are 
particularly good looking. We do the mixing by putting down one color on one 
scan line and a second color on the second scan line. Following this are four 
colors in which the second scan line is white, giving us some additional pastels. 
Finally, we have four examples of patterns in which the scan lines are used to 
emphasize, rather than minimize the texture. Two stage "curtains" and two 
"chain" effects are shown. 

Naturally, you are free to mix and match things anyway you want for your 
‘own color files. You can also use the same patterns to fill much smaller areas 
than the whole screen, although it will often take several scan lines and a few 
bytes of width to get a pleasing result. Е 

Well, that’s about all we need in the way of HIRES color theory. All you have 
to do to color any part of the screen 191 ways is to paint an 8-byte block of 
the screen with the magic bytes. If you need partial blocks, you simply continue 
the bit pattern up to the border of whatever it is you are coloring. Some colors 
will not be compatible with some borders, so you have to experiment to get the 
best overall results. 
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For patterns instead of colors, you do the same thing. Тһе only difference is 
wat you now have a mind-boggling choice of special effects at yaur disposal. 

By the way, our color names are only rough guidelines. The actual colors you 
get will vary with the tv and its color settings. 

Now all we need is a snappy program to rapidly clear the HIRES screen for 
us. Something Ше.... 


FAST BACKGROUND. SET 


Program 8-1 is a machine-language subroutine called FAST BACKGROUND. 
SET. While it is designed to fit in an alternate character slot in the НКСС of the 
DOS Toolkit, you can use it with any program in any language that needs a fast 
clear of HIRES1. Remember that the program must be located in a protected 
space. 

Many of the ideas behind this program are the same as we used inthe GENTLE 
SCROLL.SET of the previous enhancement. To give us the fastest possible screen 
erasure, we work only with the entire screen at once, use fast indexed store 
instructions, and share our loop overhead sixteen ways at once. 

There are two main parts to the program. The operating code goes from 
ЗВАРЕ to 8BFF, while a 32-value color file resides from. 58С00 to $8CFF. То 
use the program, you poke or load your choice of color or pattern into location 
$8800, which is the same ав an Applesoft POKE to 35584. This color value will 
be a number from 0 to 31. You then activate the fast background clear by 
iumping to a subroutine at 58801 or calling 85585. 

"able 8-2 shows you the color-file values as they are now. Each color takes 

8 successive bytes in the file, giving us 32 total colors or patterns in the 
one-page-long file. You can change any or all of these color values to Suit your 
own needs. 

A flowchart of the FAST BACKCROUND.SET is shown in Fig. 8-4. We first 
calculate a file pointer by multiplying the color times eight. Then, we get the first 
color byte and use this byte in 1024 places, arranged as sixteen lines of 64 bytes 
per line. Note that we only map every fourth byte of only the even scan lines 
when we put this byte down. 

We then get the second byte and put it down, again in 1024 locations. This 
is followed by the third byte and, finally, the fourth, which completes the even 
scan line mappings. 

After that, we repeat the process on the odd scan lines, starting with the fifth 
byte in the selected color file and going on until we end up on the eighth and 
final value. When you are done, you have mapped 8 cells of 4 x 2 bytes into 
1024 locations, or 8192 bytes total. Most of these bytes are on screen, while 
a few are off screen but not otherwise used. 

Program 8-2 is an Applesoft demo that either shows you your choice of all 
32 colors or patterns in order, or lets you enter and view your own patterns, or 
gives you a random-background show. It is menu driven. 

For a 32-color show, the'desired color gets POKED and the FAST BACK- 
GROUND.SET is called. Then, a several second delay takes place, and you go 
оп to the next color. Be sure to note that the screen clear takes Place on the 
color change, and not on the long viewing delay. The screen clears or changes 
literally as fast as you can blink your eye. 

To enter your own color or pattern, color-file location 0, or the eight bytes 

58С00 to 5807, is borrowed, and the pattern is stuffed in here. This 
arn is then displayed. 

The random-color show does pretty much the same thing except the program 
throws its own eight random numbers into color-file Zero. Should you want to 
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Па 2-0) 
PROGRAM 8-1 
FAST BACKGROUND SET 
LANGUAGE: APPLE ASSEMBLER NEEDS: FIELD SYNC 
MOD (OPTIONAL) 
др REESE ROS OEE кк» 
Sid + 
бт. Mt РА5Т x 
7;  *  BACKGROUND.SET * 
8; %  ($BAFF.BCFF) * 
аз * E 
10; % VERSION 1.1 * 
N (10-9-81 ) + 
Шат» 3 
13 ; ж COPYRIGHT 1981 ж 
14; * BY DON LANCASTER 5 
15 % AND SYNERGETICS * 
18:18 * 
17;  * ALL COMMERCIAL * 
18;  * RIGHTS RESERVED * 
194 e 5 
20 p 44 Od o nee | 
ЗАРЕ: 22: THIS PROGRAM GIVES А FAST HIRES 
SAFF: 23: CLEAR TO ANY OF THIRTY TWO | 
BAFF: 24 ; BACKGROUND COLORS OR PATTERNS | 
ЗАРЕ: 26; РВОМ HRCG -- 
ЗАРЕ: 28 : LOAD AS HIGHEST CHARACTER SET 
ЗАРЕ 29 1 SET USER SUB А ТО 58В01 
ЗАРЕ: 30 ; BY $9150: 01 BB 
BAFF: ak STORE COLOR (0-$1F) AT 58В00 
BAFF: 32% CTRL-A CTRL-Y DOES IT 
AFF: 34 ; РВОМ MACHINE LANGUAGE -- 
36 : PUT COLOR (90-51Ғ) ІМ 58800 
395r JSR $8B01 
ВАРР: 39 ; FROM INTEGER BASIC -- 
ВАРҒ 41. БЕТ НІМЕМ > -29953 
BAFF: 42: РОКЕ -29952, COLOR (0-31) 
BAFF: 43: CALL -29951 





























ретте 
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PROGRAM 8-1, CONT?D... 








BAFF: 45 ; FROM APPLESOFT -- 

ЗАРЕ: 47; БЕТ НІМЕМ « 35583 

ЗАРЕ: 48; РОКЕ 35584, COLOR (0-31) 

SAFF: 49; CALL 35585 

ВАРЕ: 51 ; THERE IS AN OPTIONAL "INVISIBLE" 
BAFF: 52: GLITCH ELIMINATOR BUILT INTO 

ВАРЕ: 53 ; THIS PROGRAM. ТО USE IT, YOU 

BAFF: 54 ; MUST CLEAR THE LORES SCREEN TO 

ВАРЕ: 55 ; GREY AND SHOULD HAVE THE FIELD 

BAFF: 56 ; SYNC MOD IN PLACE. 

SAFF: 58 : ТО ACTIVATE THE INVISIBLE SWITCHER -- 
SAFF: 60; POKE 35586,159 OR $8801: 9F 
ВАРР: 62: ТО TURN OFF THE INVISIBLE SWITCHER -- 
ВАРР: 64; РОКЕ 35586,04 ОК $8B02: 04 
2057: 66 HIRES  EQU 50057 

2056: 67 LORES EQU $6056 

C060: 68 SYNC EQU $co60 
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PROGRAM 8-1, CONT'D... 


ЗАРЕ: 71; ****** MAIN PROGRAM ****** 


73 DFB $00 
74 COLOR DFB $00 

04 8B 75 PICK JMP ERASE 
76 ERASE CLC 


ADJUST HRCG SET START 
COLOR POKES HERE 
OPTIONAL INVISIBLE LOCK 
FILE POINTER * 8 





00 88 77 LDA COLOR : GET COLOR 

78 ASLA ; 

79 ASLA : 

80 ASLA t 

81 TAY : SAVE COLOR FILE START 
8B0C:A2 00 82 LDX %500 т AND PUT DOWN COLOR 
8В0Е:98 83 МХТВҮТ ТҮА t RESTORE POINTER 
8В0ғ:48 в4 РНА 1 AND SAVE ON STACK 
8B10:B9 00 8C 86 LDA CFILE,Y ; CHANGE EVEN SCAN LINES 
8В13:А0 40 87 LDY %540 ; FOR 64 TRIPS 
8B15:9D 00 20 88 MAPEVN STA $2000,X  ; 
8в18:90 00 21 89 STA $2100,X ; 
8B1B:9D 00 22 90 STA $2200,X > 
881Е:90 00 23 91 STA $2300,X ; 
8B21:9D 00 28 92 STA $2800,X ; 
8824:90 00 29 93 STA $2900,X ; 
8827:9D 00 2A 94 STA $2A00,X ; 
882A:9D 00 2B 95 STA $2B00,X > 
8820:90 00 30 96 STA $3000,X ; 
8830:9D 00 31 97 STA $3100,X + 
8833:9D 00 32 98 STA 53200,Х ; 
8836:9D 00 33 99 STA $3300,X + 
8839:90 00 38 100 STA $3800,X ; 
883C:9D 00 39 101 STA $3900,X ; 
BB3F:9D 00 ЗА 102 STA $3A00,X ; 
8B42:9D 00 38 103 STA $3B00,X 7 
8845:03 104 рЕХ : GO FOUR BLOCKS TO LEFT 
8846:СА 105 DEX Ў 
8B47:CA 106 DEX ? 
8848: СА 107 DEX 5 AND REPEAT 
8849.88 108 DEY : DONE WITH 64 BYTES? 
8B4A:DO C9 109 BNE MAPEVN 5 
884С:Е8 110 INX ; FOR NEXT COLOR BYTE 
8B4D:68 111 PLA ; GET BYTE COUNTER 
8B4E:69 01 112 АРС #$01 ; AND INCREMENT 
8B50:A8 113 TAY : SAVE NEXT COLOR FILE 

=t POINTER 

8851:29 03 114 AND %503 : CHECK FOR FOURTH TRIP 
8B53:D0 B9 115 ВМЕ МХТВҮТ ; REPEAT FOR NEXT BYTE 
8B55:A2 00 117 LDX 8500 5 AND PUT DOWN COLOR 
8B57:98 118 NXBYTE TYA ; RESTORE POINTER 
8B58:48 119 PHA ? AND SAVE ON STACK 
8859:89 00 8С 120 LDA CFILE,Y ; CHANGE ODD SCAN LINES 
BB5C:A0 LDY #$40 ; FOR 64 TRIPS 























218 Enhancement 8 






885Е:90 00 
8B61:9D 00 
8B64:9D 00 
8B67:9D 00 
00 





8В91 :СА 





ВВ9А:29 03 
8в9с:ро B9 


8B9E:60 


ӨВӨР: 


BB9F:2C 60 
8BA2:10 ЕВ 
8ВА4:2С 56 
8ВА7:20 04 
BBAA:2C 60 
8BAD:10 FB 
BBAF:2C 57 
8вв2:60 


PROGRAM 8-1, CONT’ 








122 MAPODD STA 


123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 


151 


154; 


156 ТЕ5ТІ 
157 
158 
159 
160 ТЕ5Т2 
161 
162 
163 





5ТА 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
STA 
DEX 
DEX 
DEX 
DEX 
DEY 
BNE 
INX 
PLA 
ADC 
TAY 
AND 
BNE 


RTS 


*** INVISIBLE SWITCHER *** 


BIT 
BPL 
BIT 
JSR 
BIT 
BPL 
BIT 
RTS 











$2400,X 
$2500,X 
$2600,X 
$2700,X 
$2C00,X 
$2D00,X 
52Е00,Х 
82ЕОО,Х 
83400,Х 
83500,Х 
83600,Х 
$3700,Х 
$3c00,x 
53000,Х 
8ЗЕ00,Х 
$3F00,X 


MAPODD 


#501 


#503 
NXBYTE 


sync 

TEST1 
LORES 
ERASE 
sync 

TEST2 
HIRES 

















































GO FOUR BLOCKS TO LEFT 





AND REPEAT 
ONE LESS TRIP 


FOR NEXT COLOR ВУТЕ 

GET BYTE COUNTER 

AND INCREMENT 

SAVE COLOR FILE LOCATION 
FOURTH ТЕІР? 

REPEAT FOR NEXT BYTE 


EXIT WHEN DONE 





LOOK FOR VBLANK 


SWITCH TO LORES GREY 
DO FAST HIRES CLEAR 
FIND ANOTHER VBLANK 


SWITCH BACK TO HIRES 
AND EXIT 
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PROGRAM 8-1, CONT D... 


BBB3: 


8со0: 


8со0:00 00 
8С03:00 00 
8С06:00 00 
8C08:2A 55 
8COB:55 2A 
8СОЕ:2А 55 
8С10:05 АА 
8С13:АА 05 
8С16:05 АА 
8C18:7F 7Ғ 
8C1B:7F 7Е 
8С1Е:7Р 7F 
8C20:80 80 
8с23:80 80 
8C26:80 80 
8C26:55 2A 
8C2B:2A 55 
8С2Е:55 2A 
8C30:AA D5 
8C33:D5 AA 
8С36:АА 05 





8с40:11 22 
8C43:08 44 
8с46:11 22 





8C50:22 44 
8с53:11 08 
8С56:22 44 
8C58:A2 C4 
8С58:91 88 
BC5E:A2 C4 
8C60:33 


BC6E:B3 56 
8С70:6Е 5D 
8с73:77 3B 
8C76:6E 5D 
8C78:5D 3B 
8C7B:6E 77 
8C7E:5D 





165 


167 


00 169 
00 
2A 170 
4% 
08 173 
АА 
7Е 172 
ЛЕ 
80 173 
80 
55 174 
2А 
АА 175 
05 

176 
44 177 
08 

178 
08 179 
11 
88 180 
91 


3B 183 
77 
77 184 
6Е 







CFILE 


PATL 


PAT2 


PAT3 


PAT4 


PATS 


PAT6 


РАТ7 


PATS 


PAT? 


PATlO 


PATIL 


РАТ14 


РАТ15 












***** COLOR PATTERN FILE ***** 


ORG COLOR+256 
























DEB $00, $00, $00, $00, $00, $00, $00, $00 


DFB $2A,$55,$2A,$55,$2A,$55,$2A,$55 


DFB $05, SAA, $05, SAA, $D5, $AA, $05, ЗАА 


DFB $7F,S7F,$7F,97F, $7P, $7F, $7F, $7F 


DFB $80,$80, $80, $80, $80, $80, $80, $80 


DFB $55,$2A,$55,$2A,$55,$2A, $55, $2A 





DFB $AA,$D5, SAA, $D5, SAA, $D5, $AA, $05 


DFB $FP,SFF,$FF,$FF,$FF,SFF,SFF,SFF 


DFB $11,$22,$44, $08, $44, $08, $11, $22 


DFB $91, $A2,$C4, $88, $C4, $88, $91, $A2 


РЕВ $22,$44,$08,$11,$08,$11, $22,944 








DFR $A2,SC4,$88, $91, $88, $91, $A2,$C4 















$33, $66, $4C, $19, $4C, $19, $33, $66 


$B3, $E6,$CC, $99, $CC, $99, $B3,5E6 





DFB $6E, $5D,$3B,$77, $3B,$77,$6E,$5D 














DFB $5D,$3B,$77,$6E, $77, $6E, $5D, $3B 








































SNONNS ON 


848 "ва8 "ва8"8а8 "108" 408"108"408 


00$ ‘ALS ‘00S ‘ALS ‘aL$ ‘008 'aL$‘00$ 


10$ 'cs$'oz$'so$'et$'vs$'cv$'vos 


Fads ‘dd$ ‘80$ '2ё@$ ‘ess ‘Sws ‘ews ‘TOS 


3L$'aL$'aL$'aL$'NCS 'sc$'vecS'scs 


44$ *44$ ' 44$ *44$ ё5а$ 'vv$'sas'vvs 


445 "ляв" 445 448 ‘ws ‘sag ‘wes ‘sas 


8487445"4457445755%57Ү2057556%Ұ26 


Мё$'55$'чё$ ‘sos "6а8 "ум ‘Sas 'vvs 


505 "чч 'са$ ‘wwS ‘ww$ ‘sas “чч$ ‘sag 


WES ‘SS$ ‘Wes "965 'Чч$ ‘sas ‘wws "ва8 


sag ‘ww$ "ва ‘wus '55$ 'Ч©$ ‘sss ‘wes 


WES ‘SSS "ме "65 '86$ "92875657426 


Мч8 ‘sas “Мч$ ‘Sas '55$ “ЧЄ$ *55$ "мез 


яя$ ‘as *яз$ (48 53687238885 ‘aas 


аа$ ‘das “/ 45 ‘dds ‘Lag ‘aas 'аа$ 'яя$ 


чаа 


вза 


вза 


ваа 


вза 


вза 


яза 


яаа 


яаа 


яза 


наа 


aaa 


aaa 


aaa 


яла 


яла 


ТЕМА 


осма 


67d 


зеача 


1еама 


зсача 


беача 


угаана 


€@dwa 


еетча 


тема 


Осама 


втіма 


втауа 


тама 


от1ча 


тос 


002 


661 


861 


161 


961 


561 


vet 


tet 


261 


T6T 


061 


681 


881 


481 


981 


ва 
40 


оо 
00 


9% 
75 


80 
sv 


44 
sa 


dL 
ve 


чё 
чч 


sa 
ва 


хе 
са 


са 
Nc 


ме 
ме 


мм 
ме 


за 
Là 


Là 
aq 


ва 
gs 
40 
06 
aL 
aL 
то 
50 
ЕФ 
яа 
22 
tV 
aL 
aL 
че 
аа 
яа 
5а 
яа 
аа 
чч 
3L 
aL 
58 
ме 
55 
54 
са 


85 
NV 
sa 
чч 
ss 
ме 
55 
56 
Ww 
ва 
58 
99 
La 
aq 
аа 
за 
аа 


oro 


*AIGWZSSV 711145530205 жұұ 


84*ad08 
20:94226 
40:84208 
24:94028 
#2 ЗЕЯОВ 
00:0498 
Е6:ЯЯОВ 
81:4498 
мв:вяов 
40:9я08 
68: £498 
то:0а0в 
41:94268 
ме: наов 
56:8428 
44:9428 
са: сав 








Ww? 8008 
50:82028 
41:90028 
65:с008 
%2:0228 
55:39068 
са:наов 
VY:8828 
%Ч:9808 
ма: енов 
за: 0808 








ҮҮ! 9vo8 
се: смов 
мегочов 
3628 
95:89608 
Ұ2:8628 
$0:9658 
88:6608 
№2:0628 
2828 











44:8828 
34:9898 
14568208 
33:0858 





""Q.1NOO 48 муноона 














8 шәшәхиғуий 022 
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Table 8-2. Color-File Locations Used in FAST BACKGROUND.SET 








PATTERN - HEX LOCATION DECIMAL LOCATION 

о $acoo 35840 

$8C08 35848 
2 58С10 35856 
3 58С18. 35864 
4 $8C20 35872 
5 $8C28 35880 
6 $8C30 35888 
7 $8C38 35896 
8 $8C40 35904 
3 $8C48 35912 
10 58С50 35920 
" $8C58 35928 
12 58С60 35936 
13 58С68 35944 
14 58С70 35952 
15 56С78 35960 
16 $8C80 35968 
7 58С88. 35976 
18 58С%0 35984 
19 58С98 35992 
20 58СА0 36000 
21 58СА8 36008 
22 58СВ0 36016 
23 58С88. 36024 
24 sacco 36032 
25 58СС8 36040 
26 $6CDO 36048 
z 58С08 36056 
28 $8CtO 36064 
29 58СЕВ 36072 
30 58СҒО 36080 
31 $8СЕВ 36088 

e 








1. In hex, LOCATION = $8С00 + PATTERN 8 8. 
2. In decimal, LOCATION = 35840 + PATTERN #8. 


hold these values for later use, stop the program with a “Control С” at that point. 
To resume, type “КИМ” as usual. 

By the way, all the programs in this book have been modified to automatically 
exit you to the AUTO MENU program on the demo disk, so you can continuous- 
ly run things without lots of extra keystrokes. Be sure to delete the "RUN 
MENU” exit lines if you do not want this feature іп any of your programs. 


ADD-ONS AND MODIFICATIONS 


You can relocate the FAST BACKCROUND.SET anywhere you like, but notice 
that the file values will change. It is also important to start the color file on an 
exact page boundary. The space you pick must be protected from use by any 
other program. Usually, an Applesoft HIMEM command will do this for you 
either as a direct command or early in a program. 

Naturally, you cannot see a fast background HIRES clear if you are in the text 
or LORES screen modes. To actually see the fast clear, you must be in HIREST 
when you do the erasure. 
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авот) 
FIND START 
OF COLOR ($8805) 
($9810) 


SCAN BYTES 


START 
























GET NEXT 
COLOR FILE 


РДЕ WAIT TILL 


BLANKING 
TIME 





SWITCH TO 
LORES! GREY 


PUT DOWN 


1024 000 (8850) DO HIRES 
SCAN BYTES FAST 
BACKGROUND 











GET NEXT : С 
COLOR FILE ($8895) Г wam 

VALUE 1 BLANKING: 

DONE SWITCH 
WITH 000 ($8890) то 

SCANS? HIRES 





Fig. 8-4. Flowchart of FAST Fig. 8-5. Flowchart of optional ^Invisi 
BACKGROUND.SET program. Switcher.” 





There are several different ways you can pick up a clear of HIRES page Two. 
To only clear HIRES2, just change all the “2ХХХ” addresses with “4ХХХ” and 
all the “ЗХХХ” addresses with “5ХХХ” ones. You can also duplicate the entire 
Program and put it above $8000, sharing a common color file at 58С00, with 
calls to the lower part giving you a HIRES1 clear and calls to the upper part giving 
you a HIRES2 clear. 

Finally, if saving code space is important, you can also rework the МАРЕУМ 
and ће MAPODD stores into subroutines. Jump to the "2XXX" and “3ХХХ” 
subs for a page One clear and to the “4ХХХ” and "5XXX" subs for a page Two 
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PROGRAM 8-2 
FAST BACKGROUND DEMO 





Bl 














LANGUAGE: APPLESOFT 


10 REM RRR ea ae 


12 REM * * 
14 REM % FAST BACKGROUND * 
16 REM * рЕМО « 
18 REM * * 
20 REM * VERSION 1.0 * 
22 REM * (10-6-81) 5 
23 REM * > 
24 REM * COPYRIGHT 1981 " 
26 REM * BY DON LANCASTER * 
28 REM % AND SYNERGETICS * 
30 REM * * 
32 REM % ALL COMMERCIAL * 
34 REM * RIGHTS RESERVED * 
36 REM * * 
За REM XX TERRE REAR RE RAR AEH 


50 REM THIS PROGRAM TESTS AND 
52 REM DEMONSTRATES THE FAST 
54 REM BACKGROUNDER FOUND IN 
56 REM ENHANCEMENT EIGHT OF 
58 REM ENHANCING YOUR APPLE II 
60 REM VOLUME I. 


70 REM THE PROGRAM "FAST 
72 REM BACKGROUND.SET" 
74 REM IS ALSO NEEDED ON 
76 REM THE SAME DISK. 





80 REM THE FIELD SYNC MOD 
82 REM OF ENHANCEMENT #4 IS 
84 REM NOT NEEDED, BUT WILL 
86 REM GIVE BETTER RESULTS 
88 REM IF INSTALLED. 


100 ТЕХТ : HOME : CLEAR : PRINT 
: НТАВ 08: PRINT “HIRES FAST 
BACKGROUND DEMO" 

105 HIMEM: 35583: REM PROTECT F 
AST BACKGROUND.SET SPACE 


110 PRINT ".... 
: PRINT 

115 PRINT "BLOAD FAST BACKGROUND 
.SET"; REM CTRL D 








NEEDS 


FAST BACKGROUND SET 
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117 
120 
130 
140 
150 


160 
170 


200 
210 
220 
230 
235 


240 


1000 


1010 





1015 


1030 





1040 
1050 
1060 
2000 


2005 
2010 


PROGRAM 8-2, CONT'D... 





POKE 35584,0: CALL 35585: REM 
HIDE THE HGR GLITCH 

НТАВ 6: PRINT "SHALL I ..... 
": PRINT : PRINT : PRINT 

HTAB 9: PRINT "(S) SHOW STOC 
K COLORS": PRINT 

HTAB 9: PRINT "(E) ENTER A N 
EW PATTERN": PRINT 

HTAB 9: PRINT "(R) CREATE RA 
NDOM PATTERNS": PRINT 

PRINT "(Q) QUIT" 
PRINT : HTAB 18: PRINT 
HTAB 19: REM PRINT 











" THEN GOTO 





GOTO 2000 

GOTO 3000 

PRINT : PRINT 
EXIT 

REM DING-DING-DIN 





G 

HTAB 19: VTAB 19: GOTO 200: REM 
PICK MENU VALUE OR KEEP TR 

YING 

GOSUB 4000: HGR : REM GREY 

LORES FOR ERASE TIME 

VTAB 24: HTAB 5: PRINT “HIT 

ANY KEY TO RETURN TO MENU" 





VTAB 22: НТАВ 12: PRINT "НІ 
RES COLOR #"; 

FOR С = 0 ТО 31: POKE 35584 
„С: HTAB 25: PRINT C;: CALL 
35585 

FOR N = 1 TO 2000: NEXT N: REM 

DISPLAY TIME 







IF PEEK ( - 16384) > 128 THEN 
РОКЕ - 16368,0: GOTO 100 

FOR N 1 TO = PEEK ( - 
16336): NEXT N: NEXT C: ATAB 
25: PRINT " "у: GOTO 1030 

HGR : PRINT 

VTAB 21 


PRINT “ENTER DECIMAL PATTER 
М VALUES --": PRINT : PRINT 
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PROGRAM 8-2, CONT'D... 


2020 
2030 


2040 
2050 
2060 
2065 
2070 


2080 
2085 


2090 
2100 
2110 


2120 
3000 


3010 


3020 


3030 
3035 
3040 
3050 
3060 
4000 
4010 


4020 
9999 





FOR N = 1 TO В 

УТАВ 23: НТАВ 1: INPUT " "; 
АЅ(М):А(М) = VAL (AS(N)) 
VTAB 24: HTAB (N * 4 + 2): PRINT 
A(N): 

VTAB 23: HTAB l: PRINT " 

";: HTAB 1: NEXT N 

FOR М = 1 TO B: POKE 35839 + 
N,A(N): NEXT N 

FOR М = 1 TO 9:A = PEEK ( - 
16336); NEXT N 

POKE 35584,0: CALL 35585 
PRINT : VTAB 24: PRINT 

PRINT : PRINT "«SPACE» NEW 











PATTERN «M» MENU Хо»? 
НТАВ 37: СЕТ АЗ 
IF AS - " " THEN PRINT : PRINT 
GOTO 2010 


IF A$ - "M" THEN GOTO 100 
GOTO 2090 

HGR : VTAB 24: HTAB 5: PRINT 
"HIT ANY KEY TO RETURN TO ME 
NU"; 

VTAB 22: HTAB 1: PRINT " 





HTAB 5: FOR N = 1 TO 8:A(N) 

- INT (256 * RND (1)): PRINT 
A(N):: PRINT " ";: POKE 3584 

0 + N,A(N): NEXT N 

POKE 35584,0: CALL 35585: REM 
ENTER PATTERN ON SCREEN 

FOR М = 1 TO 9:A = PEEK ( - 
16336): NEXT N 

FOR N - 1 TO 3000: NEXT N: REM 

DISPLAY TIME 

IF PEEK ( - 16384) » 128 THEN 
POKE - 16368,0: GOTO 100 

GoTo 3010 

GR : COLOR- 5: FOR V = 0 TO 
39: HLIN 0,39 AT V: NEXT V: REM 
GREY LORES 

POKE 35586,159: REM INVISI 
BLE SWITCH ON 

RETURN 

END 
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clear. Note that you сап fake an indirect subroutine jump with а subroutine jump 
followed by a jump indirect command. 

Since there are lots of page Two options, we've purposely left them ой the 
program to keep things simple. Add things on in any way that you like. 

If you watch the background color demo, with line 4010 omitted, you will 
notice a faint "boxwork" glitch as you change colors. This glitch is utterly 
insignificant when compared to the royal mess you got with the old HIRES clear, 
but it is there. 

There is an add-on to the FAST BACKGROUND. SET that totally eliminates this 
tiny remaining glitch for those of you who are program perfectionists. For this 
to work, you must have the field sync mod of Enhancement 4 in place and be 
willing to clear your text screen to LORES grey or some other suitable color. 

Fig. 8-5 shows us the flowchart of the “Invisible Switcher.” What this does 
is wait till a vertical blanking time, switches you to a perfect grey screen, does 
a new fast HIRES clear with the Backgrounder, waits for another blanking time, 
and, then, returns you to HIRES. Your eye sees only an instantaneous fade from 
one color through grey to another color, totally glitch free. 

If you do not have the field sync mod in place, delete or bypass line 4010 
of Program 8-2. Otherwise, the program may hang. 

To use the Invisible Switcher, just poke 35586,159 or enter $8801 : 9F. Note 
that this invisible switcher is not for everyone, and it may in fact do more harm 
than good if vou are always returning to the same background color. Neverthe- 
less, it's there for those of you who are antiglitch purists. The Invisible Switcher 
is included in the demo of Program 8-2. 


CONTENTS OF COMPANION 
PARTS KIT 


1 each 7415151 1/8 Selector IC. 
2 each 741502 Quad NOR Cate IC. 
2 each Tv clothespin connector. 
4 each Phono jack, upright pc type. 


4 each Spade lug, crimp style 
1 each 47K resistor, 1/4 watt. 
3 each 16-ріп ПІР socket, premium 


machined-pin style. 

1 each 14-ріп ПІР socket, premium 
machined-pin style. 

1 each machined-pin socket contact. 

6 inches No. 22 stranded wire, red 
insulation. 

24 inches No. 24 solid wire, blue 

insulation. 

6 inches No. 24 solid wire, red 
insulation. 

12 inches Electronic solder. 





The parts kit costs $11.95 plus shipping and may be ordered using the at- 
tached card or directly Кот... 





Fast Backgrounder 227 








PAIA Electronics 
Box 14359 

1020 West Wilshire 
Oklahoma City, OK 73114 
Tel: 405-842-5480 


CONTENTS OF COMPANION 
DISKETTE 


‘Auto Menu 

Color Killer Demo 

Field Sync Utility Subs.Source 
Field Sync Utility Subs 

Field Sync Quick Test 
VFFS.EMPTY.SOURCE 
VFFS.EMPTY 

VFFS.BOXES 


VFFS.GRAPH 


VFFS.GIRLS 
MFFS.BYE 
VFFS.LORES 


Fun With Mixed Fields 

LORES Colors 121 

LORES1 Create 

LORES2 Create 

LORES1 

LORES2 

Gentle Scroll Set. Source 

Gentle Scroll Set 

Gentle Scroll Tester 

Fast Background.Set. Source 

Fast Background.Set 

Fast Background Demo 

PLUS — Two mystery “bonus” 
programs! 





The 26-program DOS 3.3 diskette costs only $14.95. It is fully copyable for 
your personal use only and includes complete Apple Assembler source listings. 
The disk may be de-muffined or niffumed to DOS 3.2. АЙ source listings and 
machine-language programs and modules are easily changed using the Apple 
Assembler provided on the DOS Toolkit. You can order this diskette using the 
attached card or directly ftom 


ЗҮМЕКСЕПС5 

Вох 1300 

746 First Street 
Thatcher, AZ 85552 
Tel: 602-428-4073 
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In future volumes, we will be looking at lots of exciting new ways to add 
variable resolution color and grey scale to your Apple, and ways to do spinners, 
animation, and other partial screen scrolls. We will also do in the iron statue and 
the golden clockwork canary once and for all. See you there. 





PREVIEW OF VOLUME 2 





Неге за sampler of some of the exciting new stuff you'll find in Enhancing Your Apple ll, Vol- 
ume 2, 


DAISY DUMPERS - 
Some exceptionally high quality and very fast graphics screen dumps for daisywheel 
printers. You get sharp and solid lines with perfectly square comers. 


TEN-CENT АХ - 
and easy modification of your cassette recorder that will dramatically increase 
and ease of use. 





ADVENTURE EMERGENCY TOOLKIT - 
Do in the iron statue and the golden clockwork canary once and for all. Learn about the 
three ultra-challenging “hidden” adventures buried in ALL Adventure programs. 


ЯХАУАҮ KEYBOARD IMPROVER - 
Simple and super cheap add-on hardware card that will give you auto repeat, shift key 
тод, external keypad, lap keyboard, key duration mode, and user-defined keys. Since it 
goes between the existing keyboard and the encoder, it's compatible with all existing 
softwere. 


SHOW-N-TELL AUTO MENU - 
A very user-iriendly menu system for noncomputer people. Show only what you want 
and where and how you want it, with full sound and animation, 





FAST AND EXACT FIELD SYNC - 
А low-cost hardware add-on that gives you an exact screen lock in any field. Doesevery- 
thing the mod of Enhancement 4 does, only it does it faster, simpler, and much more flex- 
ibly and conveniently. 


VIDEO SPLITS AND WIPES - 
Professional video special effects using fast exact field sync. You can smoothly wipe 
between screens or set up animated split-screen displays 


ULTRASONIC BSR INTERFACE - 
А two-dollar hardware add-on that lets you control the world with your Apple by way of 
ап ultrasonic link and а BSR controller, 


. PLUS MUCH MORE ! 








МЕ NEED YOUR HELP! 


A response card is included in the back. Please use it to tell us the best uses 
that you find for your mixed fields and the best HIRES background patterns that 
you found, along with any requests you have for future enhancements. This card 
will automatically register you for future corrections and updates@ 





IMPORTANT — Рог fastest service, 
please send each card to the right ad- 
dress. 

Parts kit orders go to PAIA. Everything 
else goes to SYNERGETICS. 


Sorry, по purchase orders or billing. We 
also cannot ship to a foreign address. 


Dealer inquiries invited, 
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А Clock cycles, 91-93, 94, 107, 108-111 
Code(s), 84 


Action files, 32-: 
ction files, 32-33 dead, 59 


Adaptor socket, 23 


Add-ons and modifications, 221-226 TENDO langage, 3937 
Address filter, 63-66 modules, 32, 107 
ALTFLD subroutine, 108, 112 pattern, 209-214 
Applesoft, 37, 39-41, 51, 96, 99, 121, 139, rational, 47, 48, 58, 59-50 
153, 154, 178-179 source, 34 

ASCII filter, 62-63 tearing into machine-language, 29-87 
Attack methods, 75 video display, 62 
Autocolor circuitry, 28 working, 32 
Autostart Color(s) 

monitor, 42, 46 background, 201-226 

reset, 18, 20, 24 band, 24-28 

ROM, 81 burst, 18, 19, 44, 93 

cell, 207-208, 209, 212 
B combinations, 205, 205-207 
complementary, 205. 206 

Background colors, 201-226 decoding circuits, 118 
а dots, 202-206, 207 

ar graphs, ; й р 
Base addresses, 160, 182-185, 202 Hits, 207,209 
BEDGE subroutine, 107, 112 oo 





Breakpoints, 81, 82 


| “Brute force" coding, 177 donatis, 19 


programmable, 17-29 





Bugs, 35 
Bulk files, 32-33, 48-49, 61, 68-69, 75 қ c 18 

lines, 

LORES, 209-210 

с pastel, 212-213 

Сей, color, 207-208, 209, 212 Patterns, 208, 210-211 
Chain, timing, 92 shifted and unshifted, 203-206 
Change detection, 83-84 Complementary colors, 205, 206 
Changeover switch, 10, 11-12 Control commands, software, 18 


Character display, 172 CRUDE, 99, 107, 112, 175 
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Dead code, 59, 87 
Debug programs, 31 
Decodirg circuits, color, 18 
Delay subroutine, 110. 
Demo programs, 152, 153 
Diagnostic helps, 81 
Disassembler, 87 
Display 
code, video, 62 
file, 118 
Documentation, 8, 34 
DOS, 38-39, 44, 51, 67, 82 
file, 38-39. 
hooks, 38, 178 
Dotis) 
color, 202-206, 207 
patterns, 209-213 
positions, 204-205 
Dummy soft switches, 139, 144 


Edge detector, 107 
Exact sync, 108-111, 112 


F 


FEDGE subroutine, 107-108, 110, 112 
тешу 
alternator, 108, 115 
mixed, 117-144 
rate timing, 91 
switch modification, 96-98 
switching, 118 
sync, 89-115, 175 
modification, 173, 175, 196, 226 
теб) 
action and bulk, 32-33 
bulk, 48-49, 61, 68-69 
color, 214,221 
design, 144 
display, 118 
filters, 60-61, 67, 69 
flag, 66-67 
locations, 144 
working, 121-144 
Filter 
address, 63-66 
ASCH, 62-63 
file, 60-61, 67, 69 
stash, 60-61, 63 
Flag Пе, 66-67 
Force feeder, 83 
Full-color mixed graphics, 18 


c 


Garbage, 8, 59, 90 
Gentle scroll, 171-200 
flowchart, 186 
program, 178, 179, 180, 185, 187-193 
Glitches), 160, 161, 201, 202, 226 
riddance, 150-151 
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Glitchies) —cont 
stomper, 150, 151, 159-169 
Glomper(s) 
о the first kind, 12-14 
of the second kind, 14-16 
two, 10, 11-16 
Graph, 153 
Graphics, 38, 90, 108, 112, 138, 160 
full-color mixed, 18 


Hardware, 159-160, 172 
color killer, 19, 24-28 
modifications, 10, 89, 159, 162-163, 196 
Hex dumps, 152-153, 154, 194 
High 
memory pointer; see HIMEM 
RAM, 35, 38-39 
- Resolution Character Generator; see 
HRCG 
HIMEM, 39-41, 99, 121 
pointer, 178, 179 
HIRES, 9, 10, 17, 19, 24, 37, 38, 90, 112, 
117,178 
base addresses, 66 
colors, 150, 159, 207, 209 
demo program, 152 
display, 153 
graphics, 66, 196 
screen(s), 66, 75, 153 
pages, 33 
subroutines, 180, 201 
шійу, 201 
Hookis) 36, 59, 81 
005, 178 
programs, 32 
scroll, 35, 85 
Horizontal 
pattems, 136-137, 139 
= rate timing, 91, 92-93 
scan lines, 119-120, 147 
sync pulse, 92, 93 
HRCG, 33-35, 44, 46, 48, 62, 75-76, 99, 
172, 178-179, 202 
Hues, 207, 210, 212-213 


Integer BASIC, 37, 39-41, 51, 121 
1/O sockets, 7, 27 
irrational code, 58 


к 
Keyboard 
buffer, 37, 38, 43, 178 
entry hooks, 36 
strobe, 41-42 
t 


Light pens, 89, 90, 95, 108, 111 
Logic analyzer, 83 














LOMEM, 39-41, 99 
Loops, 58, 176-177 
LORES, 9, 10, 17, 19, 37, 38, 90, 117, 178 
colors, 153-154, 158, 209-210 
Low 
- memory pointer; see LOMEM 
RAM, 35-38 
Luminance video, 93 


M 


Machine-language 
code, 33, 37, 138, 200 
tearing into, 29-87 
programs, 30, 32, 41, 43-44, 49, 121 
subroutine, 96, 171, 214 
Machined-pin contacts, 23 
Master timing reference, 91 
Memory 
map, 178-185 
mapping, 35 
Mixed 
fields, 117-144, 158, 159, 175 
graphics, 18, 19 
Modification(s), 19-20, 144, 150, 221-226 
hardware, 10, 26 
field-switch, 96-98 
field sync, 95-98, 173, 175 
Modulator, rf, 10, 11-12, 16, 28 
Monitor(s), 42, 46, 51, 81, 82 
system, 8 
Motion perception, 173-174 
Multiplexer, 91 
Music synthesizer card, 16 


Р 
Partial boot, 83 
Pastel colors, 212-213 
Patterns) 


codes, 209-214 
color, 208, 210-211 
dots, 209-213 
Print output hooks, 36 
Program(s) 
bugs, 35 
gentle scroll, 178, 179, 180, 185, 
187-193 
hook, 32 
locations, 44-46, 51-56 
machine-language, 30, 32, 34, 41, 43-44, 
49,121 
structure, 33 
test and debug, 31 
Programmable color killer, 17-29 
Programming, machine-language, 30-31 


RAM 
high, 35, 38-39 
low, 35-38 
user, 46 
Raster scan collisions, 174-176 


Rational code, 47, 48, 58, 59-60 
Relocatable programs, 58, 178 
Remapping, 173, 176-178, 180-181, 194 
Reset, autostart, 18, 20, 24 

RF modulator, 10, 11-12, 16, 28 


8 


Scan lines, 145, 147, 151, 207, 211, 
212-213, 214 
horizontal, 119-120 
Screen switches, 41-42 
Script, 75-76 
Scroll, 35, 83, 171, 174 
gentle, 90 
hooks, 35, 85 
subroutine, 85 
Shape table, 66 
Shifted colors, 203-206, 210 
Signal, black and white, 18 
Sockets) 
adaptor, 23 
10, 7, 27 
Soft switch, 118-119, 121, 138-139, 143, 
158 
Software, 8, 108, 159-160, 172 
color killer, 19, 23-24, 28 
control commands, 18 
support, 96-115, 117 
Source code, 34 
Split screens, 89 
Sprite maps, 66 
Stack 37 
Start-of-program pointer, 41 
Stash filter, 60-61, 63 
Stashes, 32-33, 37, 59-60, 75 
Strobe, keyboard, 41-42 
Subroutine(s), 33, 49-51, 56, 64-65, 81, 
82, 99, 107-108, 111, 149, 222, 
226 
HIRES, 201 
machine-language, 96, 171, 214 
scroll, 85 
Support software, 96-115, 117 
Switch, changeover, 10, 11-12 
System monitor, 8 


Tearing 
attack method, 34, 35 
into machine-language code, 29-87 
Test and debug programs, 31 
Text displays, 38 
Timing 
chain, 92, 94 
reference, master, 91 
video, 91 
waveforms, 91-95 
‘Two glompers, 10, 11-16 
ТХТАВ; see start-of-program pointer 
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о 
Unshifted colors, 203-206, 210 
Utility 

HIRES, 201 

subs, 96 


у 


Vertical rate timing, 93 
VFFS, 121-149 
Video 

display code, 62 


Video —cont 
Field Formatter Sub, 121; see also МЕР. 
glitch-free, 91 
luminance, 93 
timing, 91, 179 


Warranty, 23 
Working 
code, 32 
files, 121-144 





